并行 AI 编码代理编排引擎,自动调度多代理处理 Issue、CI 修复与 Code Review
Agent Orchestrator 是一个面向并行 AI 编码代理的编排调度引擎,由 ComposioHQ 维护。它为每个 Issue 启动独立的 AI 编码代理,每个代理在隔离的 git worktree 中工作,拥有独立分支和 PR。项目采用三重无关性设计——Agent 无关(支持 Claude Code、Codex、Aider、Cursor、OpenCode、Goose)、Runtime 无关(支持 tmux、process、Docker、Kubernetes、SSH、E2B)、Tracker 无关(支持 GitHub Issues、Linear、GitLab)。
核心特色在于事件驱动的 Reactions 机制:CI 失败时自动将日志发给代理修复并支持重试,Review 评论自动路由到代理处理并支持超时升级,PR Approved 且 CI 通过后可选自动合并,代理卡住时超时检测通知人类。系统内置 Web Dashboard(默认端口 3000)实时监控所有代理状态,支持多通道通知路由(Desktop、Slack、Discord、Webhook、Email),按优先级分级。
架构上采用 8 槽位插件体系(Runtime、Agent、Workspace、Tracker、SCM、Notifier、Terminal、Lifecycle),所有接口定义在 packages/core/src/types.ts,插件只需实现 TypeScript 接口并导出 PluginModule。运行时数据存储于 ~/.agent-orchestrator/,基于配置文件路径 SHA256 前 12 位哈希做全局唯一命名空间隔离,避免多实例冲突。
零配置体验:ao start 自动检测 git remote、默认分支、语言框架、可用代理运行时等。macOS 上自动使用 caffeinate 防止休眠,支持通过 Tailscale 远程访问 Dashboard。
前置依赖:Node.js 20+、Git 2.25+、tmux、GitHub CLI (gh)。当前仅支持 macOS 和 Linux(tmux 依赖限制)。采用 MIT 协议开源,主要语言为 TypeScript(92.2%),使用 pnpm monorepo workspace 管理。
安装方式:
npm install -g @aoagents/ao
ao --version
快速启动:
ao start https://github.com/your-org/your-repo
核心 CLI 命令包括 ao start、ao list、ao spawn、ao attach、ao kill、ao status、ao doctor、ao update、ao config-help。配置通过仓库中的 agent-orchestrator.yaml 文件管理,支持项目级 agentRules、reactions 策略及通知路由分级配置。
待确认事项:NPM 包名存在不一致(README 使用 @aoagents/ao,release 记录显示 @composio/ao-cli@0.2.2);GitLab/Bitbucket SCM 插件、Kubernetes/SSH/E2B runtime 插件、Jira Tracker 插件的具体可用状态未确认;是否有配套学术论文及 Hugging Face 页面待确认。