CLI 智能体
启动、监督并审阅你的外部 CLI 编码智能体——预设、程序状态、屏幕推断状态、diff 与通知。
Cordy 编排你已经在用的外部 CLI 编码智能体。它把它们启动进工作区终端,显示其状态与文件改动,并在它们需要你关注时通知你。AI 本身的工作由各智能体在自己的进程中、用自己的凭据与提供商完成。Cordy 会为渲染、恢复历史与监督处理终端输出,但不会把这些内容代理到模型服务。
自带你的智能体
Cordy 不捆绑也不安装任何智能体。请完全按照各智能体自身文档的说明来安装并认证它——用它自己的账户、提供商、模型与密钥——使得在终端里运行它的命令本就可行。然后 Cordy 便能替你启动它。
Cordy 内置六个智能体的预设:
| 智能体 | 预设命令 |
|---|---|
| Claude Code | claude |
| Codex CLI | codex |
| Cursor Agent | cursor-agent |
| Gemini CLI | gemini |
| Copilot | copilot --allow-tool=write |
| OpenCode | opencode |
每个预设都在当前工作区的项目文件夹中运行;智能体只会在项目文件夹内启动。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 从终端输出推断每个智能体的状态,并以徽章形式展示:
| 状态 | 徽章 | 含义 |
|---|---|---|
launched | Agent: launched | 进程已启动;尚未见到决定性输出。 |
running | Agent: running | 智能体正在活跃地产生输出——工作中。 |
waiting_for_input | Agent: waiting for input | 智能体正在向你提问,被你的回应所阻塞。 |
idle | Agent: idle | 仍在运行,但已安静一段时间(在预设的空闲窗口内无输出)。 |
exited | Agent: exited | 进程已结束。 |
failed | Agent: 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 审阅。
- 快捷键——命令面板与工作区按键。
- 隐私——密钥、终端输出与存储的数据。