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 来选择性地在输出中显示当前会话的污染级别。这会在每个响应前添加分级级别：

[CONFIDENTIAL] Here are your Q4 pipeline numbers...

上下文长度进度条

CLI 在终端底部的分隔行中显示实时上下文窗口使用量进度条：

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

• 随着上下文 token 被消耗，进度条会填充
• 在 70% 阈值处出现蓝色标记（自动压缩触发点）
• 接近限制时进度条变红
• 压缩后（/compact 或自动），进度条重置

MCP 服务器状态

分隔行还显示 MCP 服务器连接状态：

显示	含义
MCP 3/3（绿色）	所有配置的服务器已连接
MCP 2/3（黄色）	部分服务器仍在连接或失败
MCP 0/3（红色）	没有服务器连接

MCP 服务器在启动后在后台延迟连接。状态会随着服务器上线实时更新。

输入历史

您的输入历史跨会话持久化存储在：

~/.triggerfish/data/input_history.json

历史在启动时加载，在每次输入后保存。您可以通过删除该文件来清除它。

非 TTY / 管道输入

当标准输入不是 TTY 时（例如，从另一个进程管道输入），CLI 自动回退到行缓冲模式。在此模式下：

• 原始终端功能（方向键、历史导航）被禁用
• 从标准输入逐行读取输入
• 输出写入标准输出，不带 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	在输出中显示会话污染级别

无需设置 CLI 渠道开箱即用。您无需配置任何内容即可从终端开始使用 Triggerfish。 :::

键盘快捷键

快捷键	操作
Enter	发送消息
上 / 下	浏览输入历史
Ctrl+V	从剪贴板粘贴图片（作为多模态内容发送）
Ctrl+O	切换紧凑/展开工具显示
ESC	中断当前操作
Ctrl+C	退出 CLI
Ctrl+W	删除前一个单词
Home / End	跳转到行首/行尾