CLI Agent Orchestrator

CLI Agent Orchestrator (CAO)

English | 简体中文

CLI Agent Orchestrator (CAO) coordinates multiple AI coding CLIs so a
supervisor can delegate work to specialist agents in parallel or sequence.

📚 Documentation —
guides, reference, and two interactive courses.

What CAO does

CAO runs a local cao-server, starts provider CLIs in isolated terminal
sessions, and gives a supervisor tools for coordinating workers. The agents
remain full CLI processes with their native authentication and capabilities.
See CODEBASE.md for the runtime architecture and package layout.

Prerequisites

Install:

- Python 3.11 or later
- tmux 3.3 or later
- uv
- At least one supported provider CLI, authenticated before you launch CAO:
  Kiro CLI, Claude Code,
  Codex CLI, Antigravity CLI,
  Hermes, Kimi CLI,
  MiniMax Code,
  GitHub Copilot CLI,
  OpenCode CLI, Oh My Pi(OMP) CLI,
  Cursor CLI, or
  Grok Build CLI

The focused provider guides contain installation, authentication, and
provider-specific behavior.

Install CAO

Install the current main branch as a uv tool:

For a tagged release, install
cli-agent-orchestrator from PyPI.
See DEVELOPMENT.md for a source checkout.
For container-based installation, see the
devcontainer feature.

To update an existing CAO installation:

See Updating CAO for source-aware behavior and edge cases.

First supervisor launch

The unqualified commands below use CAO's default Kiro CLI provider. If you
installed a different provider, follow its focused guide above for the
provider override while keeping the same sequence.

1. Install the built-in supervisor profile:

2. In terminal A, start the local server and leave it running:

3. In terminal B, change to the project directory the agents should work in,
   then launch the supervisor:

4. Observe the supervisor in…