CLI Agent Orchestrator
在隔离的 tmux 会话中协调多个编码 CLI,让主管代理并行或顺序委派工作。
这个 Agent 能做什么,适合哪些场景?
CLI Agent Orchestrator(CAO)是一个本地运行的多代理编码 CLI 协调器。它启动本地的 cao-server,并在隔离的终端会话中运行提供商 CLI;这些代理仍保留各自原生的认证方式与能力。主管代理可通过 CAO 提供的工具协调工作代理,按并行或顺序处理任务。运行状态可在已附着的启动终端、Web UI、tmux 会话中观察,也可通过 shell CLI、operations MCP server 或插件进行控制。它面向已有编码 CLI 工作流、希望在一个项目目录内组织多名专长代理协作的开发团队。
先运行 cao-server 作为本地服务,再由 cao launch --agents code_supervisor 在目标项目目录启动主管代理。CAO 会启动 Kiro CLI、Claude Code、Codex CLI、Antigravity CLI、Hermes、Kimi CLI、GitHub Copilot CLI、OpenCode CLI 或 Cursor CLI 等已认证的提供商 CLI,并将其放入隔离终端会话。主管代理使用 CAO 的协调工具把工作交给工作代理,并可并行或顺序推进。操作者可在 http://localhost:9889 的 Web UI、启动终端或 tmux 中观察会话;完成后用 cao shutdown --session {session-name} 停止指定会话,或用 cao shutdown --all 停止全部 CAO 会话。
- 使用多种已认证编码 CLI 的开发者,希望由一个主管代理把同一项目中的独立编码任务分配给多个工作代理。
- 需要同时推进多个 AI-DLC 意图的工程团队,并希望在隔离工作区中协调跨仓库任务。
- 希望保留现有 Claude Code 或 Codex CLI 原生认证和能力,同时增加多代理调度层的团队。
- 需要通过本地 Web UI、tmux 或 operations MCP server 观察和操作编码代理会话的技术负责人。
这个 Agent 有哪些优点和局限?
- 以本地 cao-server 加隔离 tmux 会话的方式运行,代理保持原生 CLI 进程、认证和能力。
- 明确支持多种编码 CLI,包括 Claude Code、Codex CLI、Kiro CLI、GitHub Copilot CLI、OpenCode CLI 与 Cursor CLI。
- 同时提供启动终端、Web UI、shell CLI、operations MCP server 和插件作为控制平面。
- 运行前必须安装 Python、tmux、uv,以及至少一个已认证的受支持提供商 CLI。
- 默认启动流程使用 Kiro CLI;改用其他提供商需要遵循对应的提供商覆盖配置。
- 协调器管理的是本地终端会话,使用者需要负责启动 cao-server 并在任务结束后关闭会话。
如何安装或部署这个 Agent?
前提:安装 Python 3.10 或更高版本、tmux 3.3 或更高版本、uv,并安装至少一个受支持且已完成认证的提供商 CLI。安装当前 main 分支:
uv tool install git+https://github.com/awslabs/cli-agent-orchestrator.git@main --upgrade
cao --help
首次运行时安装内置主管配置:
cao install code_supervisor
如何使用这个 Agent?
在终端 A 启动本地服务:
cao-server
在终端 B 进入要处理的项目目录并启动主管:
cd /path/to/your/project
cao launch --agents code_supervisor
未指定提供商时,该命令使用默认 Kiro CLI 提供商;使用其他提供商时需按其提供商指南设置覆盖项。可打开 http://localhost:9889 查看 Web UI;结束指定会话:
cao shutdown --session {session-name}