Agent Orchestrator — 并行 AI Agent 的编排层

Spawn 并行 AI 编码 Agent，每个 Agent 都在其独立的 git 工作树（worktree）中运行。Agent 可以自主修复 CI 故障、处理评审意见并提交 PR —— 你只需通过一个仪表盘进行监督。

---

Agent Orchestrator 管理着一群在你的代码库上并行工作的 AI 编码 Agent。每个 Agent 都有其独立的 git 工作树、分支和 PR。当 CI 失败时，Agent 会自动修复；当评审人员留下评论时，Agent 会进行处理。只有在需要人类判断时，才会请求你介入。

Agent 中立 (Claude Code, Codex, Aider) · 运行时中立 (tmux, ConPTY/process, Docker) · 跟踪器中立 (GitHub, Linear)

查看运行演示

快速开始

前置要求： Node.js 20.18.3+, Git 2.25+, gh CLI，以及：

• macOS / Linux: tmux — 通过 brew install tmux 或 sudo apt install tmux 安装。
• Windows: 建议使用 PowerShell 7+。不需要 tmux — AO 在 Windows 上通过 runtime-process 插件使用原生的 ConPTY（默认）。如果你有 Git Bash 并倾向于使用它，请设置 AO_SHELL=bash。

安装

npm install -g @aoagents/ao

Nightly 构建版（最新的 main 分支，周五至周二每日更新）：npm install -g @aoagents/ao@nightly 切换回稳定版：npm install -g @aoagents/ao@latest

遇到权限拒绝？需要从源码安装？

如果 npm install -g 报错 EACCES，请添加 sudo 前缀或 修复 npm 权限设置。

从源码安装（贡献者适用）：

git clone https://github.com/ComposioHQ/agent-orchestrator.git
cd agent-orchestrator && bash scripts/setup.sh

Zsh 自动补全

从已安装的 CLI 生成补全文件：

mkdir -p ~/.zsh/completions
ao completion zsh > ~/.zsh/completions/_ao

然后确保该目录在 compinit 运行前已加入到 fpath 中：

fpath=(~/.zsh/completions $fpath)
autoload -Uz compinit
compinit

对于 Oh My Zsh，将生成的同一文件安装到自定义插件目录，并将 ao 添加到你的插件列表中：

mkdir -p "${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/ao"
ao completion zsh > "${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/ao/_ao"

如果你是在本地源码仓库中贡献代码，也可以将 completions/_ao 进行软链接。

启动

指定任意仓库 — 它会克隆、配置并一键启动仪表盘：

ao start https://github.com/your-org/your-repo

或者在已有的本地仓库内运行：

cd ~/your-project && ao start

就是这样。仪表盘将在 http://localhost:3000 打开，编排器（orchestrator）Agent 将开始管理你的项目。

添加更多项目

ao start ~/path/to/another-repo

工作原理

1. 启动 — ao start 启动仪表盘和一个编排器 Agent。
2. 编排器派生工作者（Worker） — 每个任务（Issue）都会在独立的 git 工作树中获得一个专属 Agent。
3. Agent 自主工作 — 它们读取代码、编写测试、创建 PR。
4. 通过反馈响应机制 — CI 失败和评审意见会自动路由回 Agent。
5. 评审与合并 — 只有在需要人类判断时，你才会被邀请参与。

编排器 Agent 在内部使用 AO CLI 来管理会话。你无需学习或使用该 CLI — 仪表盘和编排器会处理所有事务。

配置

ao start 会自动生成包含默认配置的 agent-orchestrator.yaml。你可以随后编辑它来定制行为：

# agent-orchestrator.yaml
$schema: https://raw.githubusercontent.com/ComposioHQ/agent-orchestrator/main/schema/config.schema.json
# 运行时数据在 ~/.agent-orchestrator/{hash}-{projectId}/ 下自动生成
port: 3000

defaults:
  runtime: tmux       # macOS/Linux 默认值；Windows 默认为 `process` (ConPTY)
  agent: claude-code
  workspace: worktree
  notifiers: [desktop]