# 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.

- Skill: `agentskillexchange/coordinate-multiple-cli-agents-through-sessions-handoffs-and` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/coordinate-multiple-cli-agents-through-sessions-handoffs-and`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/coordinate-multiple-cli-agents-through-sessions-handoffs-and/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/coordinate-multiple-cli-agents-through-sessions-handoffs-and

---


# 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 versions](https://img.shields.io/pypi/pyversions/cli-agent-orchestrator.svg)](https://pypi.org/project/cli-agent-orchestrator/)
- **Python 3.10 or higher** — see [pyproject.toml](pyproject.toml)
- **[uv](https://docs.astral.sh/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](#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](https://agentskillexchange.com/skills/coordinate-multiple-cli-agents-through-sessions-handoffs-and-terminal-control-apis-with-cli-agent-orchestrator/)