CLI 智能体

启动、监督并审阅你的外部 CLI 编码智能体——预设、程序状态、屏幕推断状态、diff 与通知。

Cordy 编排你已经在用的外部 CLI 编码智能体。它把它们启动进工作区终端,显示其状态与文件改动,并在它们需要你关注时通知你。AI 本身的工作由各智能体在自己的进程中、用自己的凭据与提供商完成。Cordy 会为渲染、恢复历史与监督处理终端输出,但不会把这些内容代理到模型服务。

自带你的智能体

Cordy 不捆绑也不安装任何智能体。请完全按照各智能体自身文档的说明来安装并认证它——用它自己的账户、提供商、模型与密钥——使得在终端里运行它的命令本就可行。然后 Cordy 便能替你启动它。

Cordy 内置六个智能体的预设:

智能体预设命令
Claude Codeclaude
Codex CLIcodex
Cursor Agentcursor-agent
Gemini CLIgemini
Copilotcopilot --allow-tool=write
OpenCodeopencode

每个预设都在当前工作区的项目文件夹中运行;智能体只会在项目文件夹内启动。Claude Code 与 Codex 启动时不带绕过审批的参数,各 CLI 保留自己的权限流程。如果命令不在 PATH 上,启动会像在普通 Shell 中一样失败——请先安装或登录该 CLI 再重试。

启动一个智能体

智能体预设会经过 Cordy 的运行时监督器,因此运行会获得状态徽章与通知。可从以下入口发起:

  • 终端预设栏中的 Agent presets;
  • 命令面板(Cmd/Ctrl+K):Agent 分组中的 Launch <预设> 或 Split with <预设>;或
  • 预设栏中某个预设的右键菜单:Split right with <预设> 或 Split down with <预设>。

智能体运行在工作区终端中,工作目录为项目文件夹。同一项目的所有工作区共享该文件夹,因此同一项目中的两个智能体会编辑同一组文件。如需独立检出,请把 git worktree add 创建的目录添加为单独项目。见核心概念。

要停止智能体,可使用命令面板 Stop Agent 分组中的 Stop <智能体>,或关闭其标签。点击侧栏中的智能体徽章会聚焦其标签。

状态与通知

Cordy 通过以下两种方式之一获取智能体状态。

程序状态(OSC 7501)

通过程序状态协议(OSC 7501)自行报告状态的程序(例如 Claude Code 2.1.295 或更高版本),会在任意终端标签上显示状态,无论是从预设启动还是手动启动:

标签文字含义
Working(或 Working N%)程序正在工作。
Needs approval正在等你批准某个操作。
Has a question它向你提出了问题。
Needs sign-in需要你登录。
Needs attention因其他原因被阻塞。
Finished已完成任务。
Failed已失败。

某次运行一旦以这种方式报告状态,Cordy 便不再读取其屏幕来判断状态。

自 0.6.0 起,Cordy 不再向 Claude Code 添加 hook 设置。旧版 Claude Code 仍可运行:从 Claude Code 预设启动时,它会像其他智能体一样获得屏幕推断状态;在普通标签中手动启动时则不显示状态。

屏幕推断状态

对于其他预设启动,Cordy 从终端输出推断每个智能体的状态,并以徽章形式展示:

状态徽章含义
launchedAgent: launched进程已启动;尚未见到决定性输出。
runningAgent: running智能体正在活跃地产生输出——工作中。
waiting_for_inputAgent: waiting for input智能体正在向你提问,被你的回应所阻塞。
idleAgent: idle仍在运行,但已安静一段时间(在预设的空闲窗口内无输出)。
exitedAgent: exited进程已结束。
failedAgent: failed匹配到失败模式(例如认证或配额错误)。

状态跃迁由已渲染文本匹配与超时驱动。running 模式标记成功启动;提示行上的 waiting 模式可以标记等待输入。配置了 busy 模式时,则在启动完成后,以忙碌文本消失来判断等待;busy 的优先级更高。新的非等待输出把等待或空闲状态拉回 running;超过空闲窗口(默认 30 秒,Cursor Agent 为 45 秒)的静默将 running → idle;failure 模式转为 failed;进程结束则转为 exited。CLI 可以改变界面文本,因此请把屏幕推断状态视为提示。

通知

当智能体需要你或已完成时,Cordy 会通知你:

来源通知
程序状态<工作区> · Needs approval、Has a question、Needs sign-in、Needs attention、Finished 或 Failed
屏幕推断:等待输入"Agent needs input"
屏幕推断:匹配失败模式"Agent failed"
屏幕推断:运行至少 30 秒后退出"Agent finished"
你停止智能体"Agent stopped"
  • 一次程序状态更新最多产生一条通知。同一运行的通知限流为每 5 秒一条;提问或审批请求会更快送达,但至少间隔 2 秒。
  • 自行运行不足 30 秒便退出的智能体不会产生 "finished" 通知。
  • 只要 Cordy 处于打开状态,每条通知都会以应用内 toast 出现。只有当 Cordy 窗口未聚焦时——隐藏、最小化或(在 Windows 上)收起到托盘——才会发送操作系统通知。
  • 点击操作系统通知,或应用内 toast 上的 Open,会带你到该智能体的会话。
  • 若操作系统拒绝通知,Cordy 会展示一次性的应用内警告;你仍能收到应用内 toast。

Cordy 从不替智能体回答审批。审批始终留在智能体自己的终端提示中。

审阅智能体的改动

智能体的工作会在 Changes 面板中体现为项目检出目录里的 Git 改动:单文件与逐块(hunk)暂存、取消暂存与丢弃;批量操作;冲突;以及提交、fetch、pull 与 push。执行 Pull 或切换分支前,Cordy 会提醒你该项目上仍有运行中的智能体。见文件、搜索与 Git。

自定义预设

你可以为任意命令注册自己的预设——另一个智能体、一个包装脚本,或某个内置智能体的特定调用方式。打开设置 → 终端预设,选择添加预设,并提供:

  • Display name(显示名称)与 Command (executable)(命令);
  • 可选的 Default args(每行一条)与 Env overrides(键 / 值对);
  • 可选的状态模式——Running、Waiting for input、Busy(优先于 waiting)与 Failure 模式,外加 Idle window (ms)。

工作目录始终是项目文件夹。由于预设会以你的完整用户权限、在没有沙箱的情况下运行真实命令,Cordy 会展示确切命令行的摘要供你确认——批准文案为"I authored this preset and own the command"(我编写了该预设并对该命令负责)。自定义预设存储在你本地的用户数据目录中。

Cordy 不做什么

  • Cordy 不内嵌聊天机器人,也不调用任何语言模型。
  • Cordy 不持有你的提供商 API 密钥——每个智能体从各自的环境或配置中读取自己的密钥。
  • Cordy 不把终端内容发送给自己的 AI 服务商。它会渲染终端输出,并为恢复保留有上限的普通缓冲区历史。
  • Cordy 不替智能体批准操作。Cordy 自己的确认覆盖注册自定义命令、提交或丢弃改动、破坏性关闭等 Cordy 层操作。

完整的数据边界见 隐私,启动智能体的进程监督器见 运行时。

相关页面

  • 终端——标签、分屏、程序状态与退出处理。
  • 文件、搜索与 Git——Changes 面板与 diff 审阅。
  • 快捷键——命令面板与工作区按键。
  • 隐私——密钥、终端输出与存储的数据。