Agent Orchestrator Is Not a Tool. It's Coding Infrastructure.

By Suraj Kumar ยท 2026 ยท 8 min read ยท 0 views ยท 0 likes

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.

8
Plugin Slots
3,288
Test Cases
6k
GitHub Stars

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:

The Automatic Lifecycle — What AO Handles
1

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.

Automatic
2

Agent 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.

Automatic
3

PR 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.

Automatic
4

CI + 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 needed

Notice 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:

The Self-Healing Loop
Agent writes fix, pushes CI Pipeline runs, fails AO Reactions parses logs, routes Review comments routed Auto until green or escalate

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.

โœ“ Task status — in progress, PR open, CI green, merged, or stuck
โŸณ Reaction status — how many auto-fixes, what's been escalated to you
! Attention needed — only what requires your human judgment

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.

Live Already shipping in the AO repo as openclaw-plugin
1 API call to give a personal agent full coding capabilities
0 Lines of git/CI/PR code OpenClaw had to write

But OpenClaw is just one example. The real question is: what other tools and platforms could plug into AO?

Where AO Can Be the Coding Layer

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 intent

Chat-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 market

Domain-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 integrations

Other 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 rebuild

The 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:

8 Swappable Plugin Slots — Everything Around the Core
AO Core
โš™๏ธ
Runtime
tmux · process
๐Ÿค–
Agent
claude · codex · aider
๐Ÿ“‚
Workspace
worktree · clone
๐Ÿ“‹
Tracker
github · linear · gitlab
๐Ÿ”€
SCM
github · gitlab
๐Ÿ””
Notifier
slack · discord · webhook
๐Ÿ–ฅ๏ธ
Terminal
iterm2 · web
๐Ÿ”„
Lifecycle
state machine · reactions

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.

agent-orchestrator ai-infrastructure open-source coding-agents ci-cd composio developer-tools fleet-management