CLI 頻道

命令列介面是 Triggerfish 的預設頻道。它隨時可用，不需要外部設定，是您在開發和本地使用期間與代理互動的主要方式。

分類

CLI 頻道預設為 INTERNAL 分類。終端機使用者永遠被視為擁有者——不需要配對或驗證流程，因為您是直接在自己的機器上執行該程序。

為什麼是 INTERNAL？ CLI 是一個直接的本地介面。只有能夠存取您終端機的人才能使用它。這使得 INTERNAL 成為適當的預設值——您的代理可以在此上下文中自由分享內部資料。 :::

功能

原始終端機輸入

CLI 使用原始終端機模式，具有完整的 ANSI 跳脫序列解析。這讓您直接在終端機中獲得豐富的編輯體驗：

• 行編輯——使用方向鍵導航，Home/End 鍵，Ctrl+W 刪除單字
• 輸入歷史——按上/下鍵瀏覽先前的輸入
• 建議——常用指令的 Tab 自動補全
• 多行輸入——自然地輸入較長的提示

精簡工具顯示

當代理呼叫工具時，CLI 預設顯示精簡的單行摘要：

tool_name arg  result

使用 Ctrl+O 在精簡和展開的工具輸出之間切換。

中斷執行中的操作

按 ESC 中斷目前的操作。這會透過協調器向 LLM 提供者發送中止信號，立即停止生成。您不需要等待長回應完成。

汙染等級顯示

您可以透過在 CLI 頻道設定中啟用 showTaint，選擇性地在輸出中顯示目前的 session 汙染等級。這會在每個回應前加上分類等級：

[CONFIDENTIAL] 以下是您的第四季銷售管線數據...

上下文長度進度條

CLI 在終端機底部的分隔線中顯示即時的上下文視窗使用率：

[████████████░░░░░░░░] 62% ctx  MCP 3/3

• 隨著上下文 token 的消耗，進度條會填滿
• 在 70% 閾值處出現藍色標記（自動壓縮觸發點）
• 接近限制時進度條變為紅色
• 壓縮（/compact 或自動）後，進度條重置

MCP 伺服器狀態

分隔線還顯示 MCP 伺服器連線狀態：

顯示	意義
MCP 3/3（綠色）	所有已設定的伺服器已連線
MCP 2/3（黃色）	部分伺服器仍在連線中或已失敗
MCP 0/3（紅色）	沒有伺服器已連線

MCP 伺服器在啟動後於背景延遲連線。狀態會隨著伺服器上線即時更新。

輸入歷史

您的輸入歷史跨 session 持久保存於：

~/.triggerfish/data/input_history.json

歷史在啟動時載入，每次輸入後儲存。您可以刪除該檔案來清除歷史。

非 TTY / 管道輸入

當 stdin 不是 TTY 時（例如從另一個程序管道輸入），CLI 會自動回退到行緩衝模式。在此模式下：

• 原始終端機功能（方向鍵、歷史導航）被停用
• 從 stdin 逐行讀取輸入
• 輸出寫入 stdout 時不帶 ANSI 格式

這讓您可以編寫腳本與代理互動：

echo "What is the weather today?" | triggerfish run

設定

CLI 頻道只需最少的設定。當您執行 triggerfish run 或使用互動式 REPL 時，它會自動建立。

channels:
  cli:
    interactive: true
    showTaint: false

選項	類型	預設值	說明
interactive	boolean	true	啟用互動式 REPL 模式
showTaint	boolean	false	在輸出中顯示 session 汙染等級

無需設定 CLI 頻道開箱即用。您不需要設定任何東西就能從終端機開始使用 Triggerfish。 :::

鍵盤快捷鍵

快捷鍵	動作
Enter	傳送訊息
上 / 下	瀏覽輸入歷史
Ctrl+V	從剪貼簿貼上圖片（以多模態內容傳送）
Ctrl+O	切換精簡/展開的工具顯示
ESC	中斷目前操作
Ctrl+C	退出 CLI
Ctrl+W	刪除前一個單字
Home / End	跳到行首/行尾