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
- Stars
- 997★
- Forks
- 197
- Language
- Python
- License
- Apache-2.0
- Created
- 2025-07-29
- Last push
- 2026-08-06