awslabs/cli-agent-orchestrator

View on GitHub ↗

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

1,062 ★218 forksPythonUpdated 1mo 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
1,062★
Forks
218
Language
Python
License
Apache-2.0
Created
2025-07-29
Last push
2026-08-17