Agent Orchestrator — 并行 AI Agent 的编排层

Agent Orchestrator 用于管理在代码库上并行工作的 AI 编码 Agent 集群。每个 Agent 都在独立的 git 工作树、分支和 PR 中运行。当 CI 失败时，Agent 会自动修复；当评审者提出建议时，Agent 会进行处理。仅在需要人工判断时，你才会被介入。

---

与 Agent 无关 (支持 Claude Code, Codex, Aider) · 与运行时无关 (支持 tmux, Docker) · 与追踪工具无关 (支持 GitHub, Linear)

演示

（此处应展示动态演示图）

快速入门

前置条件： Node.js 20+, Git 2.25+, tmux, gh CLI。可以通过 brew install tmux (macOS) 或 sudo apt install tmux (Linux) 安装 tmux。

安装

npm install -g @composio/ao

如果遇到权限拒绝问题？尝试从源码安装：

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

若要从源码安装（针对贡献者）：

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

启动

指向任意代码库 — 它会通过一条命令完成克隆、配置并启动仪表盘：

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

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

cd ~/your-project && ao start

只需这样，仪表盘即会在 http://localhost:3000 启动，编排器 Agent 将开始管理你的项目。

添加更多项目

ao start ~/path/to/another-repo

工作原理

1. 你启动项目 — ao start 会启动仪表盘和一个编排器 Agent。
2. 编排器生成工作者 — 每个任务都会在独立的 git 工作树中分配一个专属 Agent。
3. Agent 自主工作 — 它们读取代码、编写测试并创建 PR。
4. 通过反应处理反馈 — CI 失败和评审评论会自动路由回对应的 Agent。
5. 你负责评审与合并 — 只有在需要人工干预时，你才会被邀请介入。

编排器 Agent 内部使用 AO CLI 来管理会话。你无需学习或使用 CLI — 仪表盘和编排器会处理一切。

配置

ao start 会自动生成带有合理默认值的 agent-orchestrator.yaml。你可以稍后对其进行编辑以自定义行为：

# agent-orchestrator.yaml
port: 3000

defaults:
  runtime: tmux
  agent: claude-code
  workspace: worktree
  notifiers: [desktop]

projects:
  my-app:
    repo: owner/my-app
    path: ~/my-app
    defaultBranch: main
    sessionPrefix: app

reactions:
  ci-failed:
    auto: true
    action: send-to-agent
    retries: 2
  changes-requested:
    auto: true
    action: send-to-agent
    escalateAfter: 30m
  approved-and-green:
    auto: false # 开启可实现自动合并
    action: notify

CI 失败 → Agent 获取日志并修复。评审者请求更改 → Agent 处理这些建议。PR 被批准且 CI 通过 → 你会收到合并通知。

请查看 agent-orchestrator.yaml.example 获取完整参考，或运行 ao config-help 查看完整配置模式。

插件架构

系统提供八个插槽，每个抽象层均可替换。

插槽	默认值	替代方案
Runtime (运行时)	tmux	docker, k8s, process
Agent	claude-code	codex, aider, opencode
Workspace (工作区)	worktree	clone
Tracker (追踪器)	github	linear
SCM (版本控制)	github	—
Notifier (通知器)	desktop	slack, composio, webhook
Terminal (终端)	iterm2	web
Lifecycle (生命周期)	core	—

所有接口均定义在 packages/core/src/types.ts。一个插件只需实现一个接口并导出 PluginModule 即可。