awslabs/cli-agent-orchestrator
开发工具用一个 supervisor 调度多个 AI 编程 CLI,每个 worker 运行在独立的 tmux 会话中。
项目介绍
CLI Agent Orchestrator(CAO)用于协调 Claude Code、Kiro、Codex、Copilot CLI、Cursor CLI 等 AI 编程 CLI:由一个 supervisor agent 把任务分派给专门的 worker agent,可并行也可按顺序执行。worker 仍是完整的 CLI 进程,保留各自的原生认证和能力;CAO 在本地启动 cao-server,在相互隔离的 tmux 会话里拉起各 provider CLI,并给 supervisor 提供管理这些会话的工具。它适合已经在用一两个编程 CLI、希望把任务拆给多个 agent 而不用手动切换终端的开发者。
文档站包含指南、参考和两门交互课程,代码库指南说明了运行时架构和包布局。
安装
前提条件:Python 3.11+、tmux 3.3+、uv,以及至少一个已完成认证的受支持 provider CLI。README 列出的 provider 包括 Kiro CLI、Claude Code、Codex CLI、Antigravity CLI、Hermes、Kimi CLI、Qwen Code、MiniMax Code、GitHub Copilot CLI、OpenCode CLI、Oh My Pi、Cursor CLI 和 Grok Build CLI,每个都有单独的说明,例如 Claude Code 指南和 Codex CLI 指南。
把当前 main 分支安装为 uv 工具,然后检查 CLI:
uv tool install git+https://github.com/awslabs/cli-agent-orchestrator.git@main --upgrade
cao --help
带标签的发布版可从 PyPI 安装;源码检出参见开发指南,容器环境参见 devcontainer 特性。已有安装可用 cao update 更新。
首次启动 supervisor
默认 provider 是 Kiro CLI。先安装内置的 supervisor profile,启动服务端,再在 agent 要工作的项目目录中启动 supervisor:
cao install code_supervisor
在终端 A 中保持服务端运行:
cao-server
在终端 B 中:
cd /path/to/your/project
cao launch --agents code_supervisor
在启动终端观察 supervisor,或打开 http://localhost:9889 的 Web UI(见 Web UI 指南),也可按 tmux 指南附加到会话。结束命名会话用 cao shutdown --session {session-name},结束全部会话用 cao shutdown --all。如果安装的是其他 provider,按其指南中的 provider 覆盖方式操作,步骤顺序不变。
运行与扩展
除基本 supervisor 外,CAO 还提供用于定时和多步流水线的 flows 与 workflows、用于 provider 选择和覆盖的 agent profile、用于一次性辅助 agent 的临时 agent、用于复用指导和跨会话状态的 skills 与 memory,以及基于角色白名单的工具限制。Web UI 与 API和 EKS 部署示例分别覆盖浏览器控制和集群运行。Agent 插件已经实现,但默认通过 CAO_AGENT_PLUGINS_ENABLED 关闭;未开启时相关路由返回 404。
使用约束
CAO 是本地编排层,不提供模型本身:需要至少一个已认证的 provider CLI,且不同 provider 的行为有差异。它依赖 tmux 会话,实际需要支持 tmux 3.3+ 的类 Unix 环境。未加 provider 参数的默认命令使用 Kiro CLI。Agent 插件默认关闭。项目采用 Apache-2.0 许可证,安全策略给出了漏洞报告和部署指导。
HotRepo 点评
2026-11-19 当天 CAO 新增 9 个 Star,在 Python 日榜上的最好名次为第 13;它没有被记录过全部语言日榜名次,因此能看到的热度范围仅限于 Python 榜。项目正处在多 agent 编程工作台这条线上,比较特别的一点是 worker 不是被框架重新实现,而是保留为 tmux 下的完整 CLI 进程,各 provider 自己的认证和能力因此不受影响。是否采用,主要值得先评估 provider 覆盖范围和不同 provider 之间的行为差异。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- getpaseo/paseo在桌面、移动端、Web 和终端统一编排多个编码智能体 CLI,由本机 daemon 自托管运行。
- smtg-ai/claude-squad在终端里统一管理多个 AI 编程代理,每个任务使用独立的 tmux 会话和 git worktree 隔离工作区。
- eneskirca/nodeterm把多个终端和并行 AI 编程代理作为可拖拽节点铺在无限画布上,让每个会话的位置和状态一眼可见,适合同时跑多个代理的开发者。
- mvschwarz/openrig把 Claude Code、Codex 等编码 Agent 组织成有角色、共享上下文和任务归属的持久团队。
- Yeachan-Heo/oh-my-claudecode让一队 Claude Code 智能体协同完成一个编程任务,而不是反复指挥单个智能体。