Agentic orchestrator for parallel coding agents — plans tasks, spawns agents, and autonomously handles CI fixes, merge conflicts, and code reviews
Agent Orchestrator is an orchestration engine for parallel AI coding agents, maintained by ComposioHQ. It spawns independent AI coding agents per issue, each working in an isolated git worktree with its own branch and PR. The project follows a triple-agnostic design — Agent-agnostic (Claude Code, Codex, Aider, Cursor, OpenCode, Goose), Runtime-agnostic (tmux, process, Docker, Kubernetes, SSH, E2B), and Tracker-agnostic (GitHub Issues, Linear, GitLab).
The core differentiator is an event-driven Reactions system: CI failures automatically route logs to agents for fixing with configurable retries, Review comments are auto-forwarded to agents with escalation timeouts, PR Approved + CI Green can trigger auto-merge, and stuck agents are detected via timeout with human notification. A built-in Web Dashboard (default port 3000) provides real-time monitoring of all agent states, with multi-channel notification routing (Desktop, Slack, Discord, Webhook, Email) prioritized by severity.
The architecture features an 8-slot plugin system (Runtime, Agent, Workspace, Tracker, SCM, Notifier, Terminal, Lifecycle) with all interfaces defined in packages/core/src/types.ts — plugins simply implement a TypeScript interface and export a PluginModule. Runtime data is stored in ~/.agent-orchestrator/, using the first 12 characters of the SHA256 hash of the config file path for globally unique namespace isolation, preventing multi-instance conflicts.
Zero-config experience: ao start auto-detects git remote, default branch, language framework, and available agent runtimes. On macOS, it automatically uses caffeinate to prevent sleep, and supports remote Dashboard access via Tailscale.
Prerequisites: Node.js 20+, Git 2.25+, tmux, GitHub CLI (gh). Currently supports macOS and Linux only (tmux dependency). MIT licensed, primarily written in TypeScript (92.2%), managed as a pnpm monorepo workspace.
Installation:
npm install -g @aoagents/ao
ao --version
Quick start:
ao start https://github.com/your-org/your-repo
Core CLI commands include ao start, ao list, ao spawn, ao attach, ao kill, ao status, ao doctor, ao update, ao config-help. Configuration is managed via agent-orchestrator.yaml in the repository, supporting per-project agentRules, reactions policies, and priority-based notification routing.
Unconfirmed items: NPM package name inconsistency (README uses @aoagents/ao, release records show @composio/ao-cli@0.2.2); actual availability of GitLab/Bitbucket SCM plugins, Kubernetes/SSH/E2B runtime plugins, and Jira Tracker plugin; existence of accompanying academic papers and Hugging Face pages.