Agent 集成
在多 Agent 并发协同开发时，了解各个命令行 Agent（如 Claude Code、Codex 等）是否在后台完成任务或正在等待授权是保持高效流程的关键。Condr 提供了直观的状态监控与通知机制。
Condr 仅对官方提供集成的 Agent 提供支持，分为两个级别，取决于 Agent 的 Hook 能汇报的状态信息。如果你常用的 CLI 尚未收录，欢迎提交 Issue 或 PR。
该级别的 Agent Hook 能明确报告会话轮次的开始与结束，并能区分主 Agent 与子 Agent，因此 Working 和 Idle 状态准确可靠。Claude Code、Codex、OpenCode、Pi、Oh My Pi、Antigravity CLI、Grok Build、Cursor CLI 与 GitHub Copilot CLI 均属于完整支持。
Cursor CLI 与 Antigravity CLI 的 Hook 缺少权限弹框事件，因此在等待授权时不会显示为 Blocked。但 Antigravity CLI 在主动向你提问等待回复时，仍会正常显示为 Blocked。
Condr 从进程识别此类 Agent：运行时侧边栏会显示其图标，退出后图标消失，并且支持通过 condr agent start 启动。由于其 Hook 无法提供可靠的状态报告，Condr 不会为其安装 Hook，状态固定显示为 Unknown。同时因为缺少 Hook 记录的会话 ID，Server 重启后无法自动恢复会话。
对这类 Agent 运行 condr agent wait 与 condr agent prompt --wait 时，会直接返回 agent_reports_no_state 报错，不会等待超时。不带 --wait 的 condr agent prompt 则可以正常发送指令。
目前仅 Kimi Code 属于这一级，因为它的 Hook 无法区分主 Agent 与子 Agent 的 Stop 事件。在 Settings › Agent integrations 中，它被标为 Recognition only。
准备与检查 Agent
Section titled “准备与检查 Agent”在 Condr 中运行 Agent 前，需要确认 Condr 服务端能够识别对应的命令行工具。
- 检查可用 Agent：在终端中运行
condr agent available命令， Condr 会列出当前在环境变量PATH中找到的所有支持的 Agent 工具。 - PATH 继承机制：Condr 服务端在启动时继承系统
PATH，但不会读取 Shell 配置文件（如.zshrc）中的 Alias 或自定义路径。 - 排查找不到命令：请将 Agent 安装至系统全局
PATH（如/usr/local/bin），或在终端环境中执行condr server restart重启服务端。
安装 Hook 监听精准状态
Section titled “安装 Hook 监听精准状态”传统的终端管理工具依赖屏幕文本正则匹配，容易因输出变动导致误判。Condr 只采信 Agent 自己说的话。支持终端 Program Status Protocol（OSC 7501）的 Agent 会直接向 Condr 的终端上报状态，无需任何安装：Claude Code 2.1.295、Codex 0.163、Pi 1.1、Oh My Pi 18.8.7、Grok Build 1.0.52、Antigravity CLI 1.4 及更新版本都支持。Hook 仍然有用：它记录 Server 重启后恢复会话所需的会话 ID，负责其余 Agent 的状态上报；在 Windows Server 上，Claude Code 和 Pi 对该协议的探测会失败，由 Hook 顶上。
- 一键安装 Hook：执行命令
condr agent hooks install <agent>（例如condr agent hooks install claude）。 - 图形化管理界面：前往 Settings › Agent integrations 直接安装。
- 查看与卸载：使用
condr agent hooks status <agent>查看状态；如需移除，执行condr agent hooks uninstall <agent>。
Agent 状态指示
Section titled “Agent 状态指示”Agent 上报后，侧边栏会显示各个窗格（Pane）中 Agent 的实时运行状态：
| 状态标识 | 状态说明 |
|---|---|
| Working | 正在执行任务（推理思考、生成文本或调用工具）。 |
| Blocked | 阻塞状态，等待用户输入、授权或登录（在 Needs you 中列出，并显示它在等什么）。 |
| Error | 本轮失败，Agent 已停住（在 Needs you 中列出，并显示原因）。 |
| Done | 完成了一轮你还没看过的工作。打开其 Pane，或 Agent 发现你回来后，显示为 Idle。 |
| Idle | 空闲状态，当前轮次完成，等待新指令。 |
| Unknown | 原生 Shell 会话，或尚未上报的 Agent。 |
| Bell | 终端发出响铃提醒（Bell 优先级高于常规生命周期状态）。 |
提示：当处于后台的 Agent 完成任务、失败或触发阻塞时，Condr 会推送系统原生通知，点击直接定位至相应窗格。
常见 Agent 配置须知
Section titled “常见 Agent 配置须知”- Codex：完成 Hook 安装后，需在 Codex 内部运行
/hooks命令并确认信任。 - Antigravity：安装后需在其设置中打开 Condr 插件。
- Pi / Oh My Pi：若使用了多个 Profile，每个 Profile 均需独立安装一次 Hook。