awslabs/cli-agent-orchestrator

Multi-agent orchestration for AI coding CLIs — Claude Code, Kiro, Codex, and more, coordinated in isolated tmux sessions

997 ★197 forksPythonUpdated 23h ago

What you need to know

CLI Agent Orchestrator (CAO) coordinates multiple AI coding CLIs so a supervisor can delegate work to specialist agents in parallel or sequence — it runs a local cao-server, starts provider CLIs in isolated tmux sessions, and gives a supervisor MCP/web/shell control-plane tools.

Install

uv tool install git+https://github.com/awslabs/cli-agent-orchestrator.git@main --upgrade (or install cli-agent-orchestrator from PyPI)
Prerequisites: Python 3.10+, tmux 3.3+, uv, and at least one supported provider CLI authenticated before launch (Kiro, Claude Code, Codex, Antigravity, Hermes, Kimi, GitHub Copilot CLI, OpenCode, or Cursor CLI)

Usage

  • cao install code_supervisor (install the built-in supervisor profile)
  • Terminal A: cao-server (start the local server)
  • Terminal B in the project dir: cao launch --agents code_supervisor
  • cao shutdown --session {session-name} (or cao shutdown --all) to stop

Key features

  • Coordinates specialist coding-agent CLIs in isolated terminal sessions with native auth preserved
  • Control planes: Web UI (localhost:9889), shell CLI, operations MCP server, and plugins
  • Flows and workflows for scheduled runs and multi-step pipelines
  • Persistent cross-session memory plus opt-in self-learning (workflow outcomes into lessons)
  • HTTP API and PTY WebSocket for terminal streaming; roles/allowlists via tool restrictions

Best for

Running parallel or sequential multi-agent workflows with a supervisor delegating to specialist coding CLIs (e.g. AI-DLC portfolio work across repos)

Caveats

  • Requires tmux 3.3+, Python 3.10+, and uv; at least one provider CLI must be installed and authenticated first
  • Unqualified commands default to the Kiro CLI provider — other providers need a provider override
Platforms: Unix-like (tmux-based)Clients: Operates provider CLIs: Kiro, Claude Code, Codex, Antigravity, Hermes, Kimi, GitHub Copilot CLI, OpenCode, Cursor CLI
Documentation ↗

Reviewed 2026-08-07

Topics

agent-orchestrationai-agentsai-coding-assistantantigravityclaude-codecodexcopilot-clicursor-clideveloper-toolshermeskimi-clikiromcpmodel-context-protocolmulti-agent-systemsopencodeorchestrationpythontmux
View on GitHub ↗
Stars
997★
Forks
197
Language
Python
License
Apache-2.0
Created
2025-07-29
Last push
2026-08-06