Coordinate multiple CLI agents through sessions, handoffs, and terminal control APIs with CLI Agent Orchestrator

Lets an agent supervisor spawn and steer isolated terminal-based worker agents with explicit handoff, assign, and message patterns.

Prerequisites

Python 3.10+, tmux 3.3+, uv, supported CLI developer agents

Installation

Use the upstream install or setup path that matches your environment:

• brew install python@3.12

• 3. Install uv

• uv tool install git+https://github.com/awslabs/cli-agent-orchestrator.git@main --upgrade
• uv tool install cli-agent-orchestrator --upgrade

Requirements and caveats from upstream:

• 
• Python 3.10 or higher — see pyproject.toml
• uv — fast Python package installer and virtual environment manager

Basic usage or getting-started notes:

• Headless agent execution in CI — cao launch --headless --async to run tasks unattended.

• Cross-provider mixing — run workers on different CLIs in the same session. Pin a profile to a provider via agent frontmatter. See Cross-Provider Orchestration.

• curl and git — for downloading installers and cloning the repo

• Source: https://github.com/awslabs/cli-agent-orchestrator

• Extracted from upstream docs: https://raw.githubusercontent.com/awslabs/cli-agent-orchestrator/HEAD/README.md

Documentation

• https://github.com/awslabs/cli-agent-orchestrator

Source

• Agent Skill Exchange