Agent Orchestrator Is Not a Tool. It's Coding Infrastructure.
You stop thinking about code. You start thinking about tasks. AO handles everything in between — lifecycle, CI, reviews, and visibility.
When you use AO, you don't manage code. You don't manage branches, worktrees, or CI pipelines. You manage tasks. "Fix the login bug." "Add the search feature." "Resolve issue #42." AO takes it from there — and you only get pulled back in when there's a decision to make.
That's what makes it infrastructure. Not that it runs coding agents — lots of tools do that. But that it takes over the entire lifecycle of a code change: from task assignment to merged PR, including every CI failure and review comment in between. You don't think about what's happening internally. You think about whether the task is done.
01 — WHAT CODING INFRASTRUCTURE MEANSYou Manage Tasks, Not Code
When most people hear "AI coding tool," they picture a terminal where an agent writes code. You watch it. You check if it's right. You push the PR. You babysit the CI. You forward the review comments. You're the glue.
That's a tool. It helps you write code faster, but you're still managing every step.
Infrastructure is different. Infrastructure is what disappears. You don't think about how your database replicates across regions. You don't think about how Stripe routes a payment through banking networks. It just works. You think about your product.
AO does the same for code changes. Here's what you stop thinking about:
Without Infrastructure
- Which branch is this agent on?
- Did I set up the worktree correctly?
- CI failed — which agent caused it?
- Reviewer left comments — how do I forward them?
- Is agent #7 still running or did it crash?
- Did this PR get merged or is it stuck?
- How do I clean up 15 dead worktrees?
With AO
- Is issue #42 done?
- Is PR #247 green?
- What's stuck and needs my attention?
- What can I merge right now?
That's the mental shift. The left column is managing code. The right column is managing tasks. AO exists so that the entire left column becomes invisible to you.
02 — AUTOMATIC LIFECYCLEFrom Task to Merged PR, Hands-Off
When you give AO a task, it takes over the full lifecycle of that code change. Not just "write code" — everything from workspace setup to PR merge. Here's what happens automatically:
Workspace Creation
AO creates an isolated git worktree with its own branch. Every agent works in its own sandbox — no interference between tasks, no merge conflicts between agents. You never see this happen.
AutomaticAgent Spawning
AO launches a coding agent (Claude Code, Codex, Aider — your choice) in a managed runtime. The agent reads the codebase, understands the task, writes the code, and runs tests. You don't configure any of this.
AutomaticPR Creation
When the agent finishes, AO commits the changes, pushes the branch, and opens a pull request with a description of what was changed and why. The PR appears in your repo like any human-written PR.
AutomaticCI + Review + Fix + Merge
CI runs. If it fails, AO handles it (more on this in the next section). Reviewer leaves comments — AO routes them back. When the PR is approved and green, you get a notification. You review, merge, done.
Automatic until you're neededNotice the pattern: every step is automatic until there's a decision that requires human judgment. You're not absent from the process — you're the final reviewer. But everything between "here's a task" and "here's a PR ready for your review" is handled.
A tool asks you to manage each step. Infrastructure manages the steps and only surfaces the outcome. AO surfaces outcomes — green PRs, ready to merge — not intermediate states.
03 — SELF-HEALING PIPELINECI Fails and Review Comments Resolve Themselves
This is the part that makes AO infrastructure rather than just a process launcher.
With any other setup: CI fails → you get a notification → you read the logs → you figure out which agent caused it → you manually send the error back → you wait → you check again. With 30 agents running, this becomes a full-time job.
AO's reaction system closes this loop automatically:
Here's how it's configured — three reactions, each fully automatic:
# agent-orchestrator.yaml
reactions:
ci-failed:
auto: true
action: send-to-agent # Logs go back to the agent
retries: 2 # Agent gets 2 attempts to fix
changes-requested:
auto: true
action: send-to-agent # Review comments go to agent
escalateAfter: 30m # If not resolved in 30min, notify you
approved-and-green:
auto: false
action: notify # You decide when to merge
CI fails? AO reads the failure logs, identifies which agent's PR caused it, and sends the logs back to that agent. The agent reads the error, fixes the code, pushes again. CI re-runs. If it passes — you never knew there was a failure. If it fails twice — then AO escalates to you.
Reviewer requests changes? Same loop. AO routes the comments to the agent. The agent addresses them and pushes an update. The reviewer only sees a resolved conversation.
This is what turns "run some agents" into actual infrastructure. The system heals itself. You only get involved when it can't.
04 — FLEET VISIBILITYManaging 30 Agents from One Dashboard
When you have one agent, you can just watch the terminal. When you have 30, you need a different mental model. You need to manage a fleet.
AO's dashboard gives you visibility across all running sessions — not by showing you 30 terminals, but by showing you what matters: which tasks are in progress, which PRs are green, which agents are stuck, and what needs your attention.
What the Dashboard Shows You
The dashboard isn't a wall of terminals. It's a management plane — organised around tasks and outcomes, not processes and logs.
You can see all 30 agents at a glance. Issue #12 is done, PR merged. Issue #18 is in progress, agent working. Issue #23 had a CI failure, agent fixed it on retry 1. Issue #31 is stuck — agent needs your input. That's the only one you need to look at.
And if you do want to see what's happening inside an agent's session, you can drill down — open the terminal, see the code, read the logs. But you don't have to. The dashboard tells you everything at the task level.
This is the difference between managing code and managing a fleet. You're not reading diffs. You're not checking branches. You're asking: "Out of my 30 tasks, which ones are done, which are in progress, and which need me?" That's infrastructure-level visibility.
05 — WHO'S PLUGGING INAO as the Coding Layer for Other Tools
If AO is infrastructure, then other software should be able to plug into it and gain coding capabilities without building them from scratch. That's already happening — and the surface area is much bigger than you'd expect.
Already Built: OpenClaw + AO
The AO repo already has an openclaw-plugin — a working integration where OpenClaw, a personal agent/orchestrator, uses AO as its coding backend. You send a message on Telegram: "fix the login bug." OpenClaw parses the intent, calls AO's API, and AO takes over — worktree, agent, PR, CI, the full lifecycle. You get a merged PR back. OpenClaw never had to learn git.
But OpenClaw is just one example. The real question is: what other tools and platforms could plug into AO?
Personal AI Agents
Tools like Hermes, OpenClaw, or any personal assistant running on a VPS. These agents are great at conversations, scheduling, and task management — but can't code. Plug in AO, and they can spawn coding agents, open PRs, and ship features on your behalf.
Natural fit — agent already understands intentChat-Based Platforms
WhatsApp bots, Slack bots, Discord bots, Telegram bots. A Bangalore startup builds a WhatsApp agent for scheduling — great at its niche, zero coding ability. One AO integration: now it can take "fix the search on our app" and deliver a PR. The bot stays focused on its domain. AO handles the coding infra.
Massive addressable marketDomain-Specific Agents
A DevOps agent that monitors your infra and auto-fixes config drift — by actually writing and deploying the fix. A QA agent that finds bugs and opens PRs to resolve them. A security agent that detects vulnerabilities and patches them. None of these need to build git workflows. AO provides the coding backbone.
High-value vertical integrationsOther Coding Tools
Even tools that already do coding — like OpenCode or custom in-house agents — can leverage AO for the orchestration layer specifically: parallel execution, worktree isolation, the reaction engine, fleet management. Instead of rebuilding these primitives, plug into AO and focus on what makes your tool different.
Leverage instead of rebuildThe pattern is the same every time: a tool that's excellent at its niche — conversations, monitoring, security scanning, scheduling — but can't code. AO gives it coding capabilities without it having to understand git, CI, PRs, or worktrees. One integration, and any software becomes coding-capable software.
06 — UNDER THE HOODWhat You Never Have to Think About
The reason AO can offer this "think about tasks, not code" experience is because it handles a set of hard infrastructure problems internally. You don't need to know how these work — that's the point — but here's what's happening underneath:
Every component is a plugin with a single TypeScript interface. Runtime? A plugin — swap tmux for Docker. Agent? A plugin — swap Claude Code for Codex. Tracker? A plugin — swap GitHub Issues for Linear. You configure it once in a YAML file and never think about it again.
The core handles what stays constant: workspace isolation (each agent gets its own git worktree), the reaction engine (CI failures and review comments routed automatically), session management (spawn, monitor, restart, kill), and the PR lifecycle (create, update, merge, clean up).
This is infrastructure in the classical sense: a reliable layer that handles complexity so the user doesn't have to. You don't think about worktrees. You don't think about tmux sessions. You don't think about which agent is on which branch. AO handles it. You think about tasks.
07 — TRY ITTwo Commands
npm install -g @composio/ao
ao start https://github.com/your-org/your-repo
Dashboard opens at localhost:3000. The orchestrator starts managing your project. Give it a task. Walk away. Come back to a PR.
That's the experience of coding infrastructure. Not "help me write code faster." But "take this task, handle everything, and tell me when it's ready."
Open source. MIT licensed. 6k stars.
GitHub: ComposioHQ/agent-orchestrator
Discord: Join the community
A tool helps you write code. Infrastructure takes a task and delivers a result. AO is the second one — automatic lifecycle, self-healing CI, fleet visibility, and the freedom to think about what matters instead of how it gets done.