cli-agent-orchestrator
Multi-agent orchestration for AI coding CLIs — Claude Code, Kiro, Codex, and more, coordinated in isolated tmux sessions
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/awslabs/cli-agent-orchestrator with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/awslabs/cli-agent-orchestrator'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/awslabs--cli-agent-orchestrator)HTML
<a href="/listings/awslabs--cli-agent-orchestrator"><img src="/api/listings/awslabs--cli-agent-orchestrator/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install the current `main` branch as a uv tool:
uv tool install git+https://github.com/awslabs/cli-agent-orchestrator.git@main --upgrade cao --help
For a tagged release, install [`cli-agent-orchestrator` from PyPI](https://pypi.org/project/cli-agent-orchestrator/). See [DEVELOPMENT.md](DEVELOPMENT.md) for a source checkout. For container-based installation, see the [devcontainer feature](docs/devcontainer-feature.md).
To update an existing CAO installation:
cao update
See [Updating CAO](docs/updating.md) for source-aware behavior and edge cases.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 210 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- <!-- An absolute raw URL, not a repo-relative path: this file is also the PyPI
- long description (see `readme` in pyproject.toml) and PyPI cannot resolve
- relative paths.
- The banner is used rather than the bare mark because it supplies its own
- background, so the mark's navy never has to survive a backdrop it cannot
- see. The bare mark would need a <picture>/prefers-color-scheme swap, since
- that navy contrasts at only 1.77:1 on GitHub's dark theme, and PyPI allows
- <img> but not <picture>, so that markup would either be dropped or escaped
- into visible tag soup depending on how it sanitizes.
- The same constraint means the banner cannot be swapped per theme either.
- It is light, matching PyPI and GitHub's light theme, and it shows as a
- bright panel on GitHub's dark theme. That is a deliberate trade, not an
- oversight. Keep in sync with README.zh-CN.md. -->
- <p align="center">
- <img src="https://raw.githubusercontent.com/awslabs/cli-agent-orchestrator/main/docusaurus/static/img/cao-social-card.png"
- alt="" width="640">
- </p>
- # CLI Agent Orchestrator (CAO)
- [English](README.md) | [简体中文](README.zh-CN.md)
- [](https://pypi.org/project/cli-agent-orchestrator/)
- [](https://pypi.org/project/cli-agent-orchestrator/)
- [](https://deepwiki.com/awslabs/cli-agent-orchestrator)
- **CLI Agent Orchestrator (CAO)** coordinates multiple AI coding CLIs so a
- supervisor can delegate work to specialist agents in parallel or sequence.
- 📚 **[Documentation](https://awslabs.github.io/cli-agent-orchestrator/)** —
- 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](CODEBASE.md) for the runtime architecture and package layout.
- ## Prerequisites
- Install:
- - Python 3.11 or later
- - tmux 3.3 or later
- - [uv](https://docs.astral.sh/uv/)
- - At least one supported provider CLI, authenticated before you launch CAO:
- [Kiro CLI](docs/kiro-cli.md), [Claude Code](docs/claude-code.md),
- [Codex CLI](docs/codex-cli.md), [Antigravity CLI](docs/antigravity-cli.md),
- [Hermes](docs/hermes.md), [Kimi CLI](docs/kimi-cli.md),
- [Qwen Code](docs/qwen-cli.md),
- [MiniMax Code](docs/minimax-code.md),
- [GitHub Copilot CLI](docs/copilot-cli.md),
- [OpenCode CLI](docs/opencode-cli.md), [Oh My Pi(OMP) CLI](docs/omp-cli.md),
- [Cursor CLI](docs/cursor-cli.md), or
- [Grok Build CLI](docs/grok-cli.md)
- The focused provider guides contain installation, authentication, and
- provider-specific behavior.
- ## Install CAO
- Install the current `main` branch as a uv tool:
- ```bash
- uv tool install git+https://github.com/awslabs/cli-agent-orchestrator.git@main --upgrade
- cao --help
- ```
- For a tagged release, install
- [`cli-agent-orchestrator` from PyPI](https://pypi.org/project/cli-agent-orchestrator/).
- See [DEVELOPMENT.md](DEVELOPMENT.md) for a source checkout.
- For container-based installation, see the
- [devcontainer feature](docs/devcontainer-feature.md).
- To update an existing CAO installation:
- ```bash
- cao update
- ```
- See [Updating CAO](docs/updating.md) 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:
- ```bash
- cao install code_supervisor
- ```
- 2. In terminal A, start the local server and leave it running:
- ```bash
- cao-server
- ```
- 3. In terminal B, change to the project directory the agents should work in,
- then launch the supervisor:
- ```bash
- cd /path/to/your/project
- cao launch --agents code_supervisor
- ```
- 4. Observe the supervisor in the attached launch terminal, open the
- [Web UI](docs/web-ui.md) at `http://localhost:9889`, or follow the
- [tmux guide](docs/tmux.md) to attach to its session.
- 5. Stop the named session when finished:
- ```bash
- cao shutdown --session {session-name}
- ```
- To stop every CAO session instead, run `cao shutdown --all`.
- ## Where to go next
- ### Operate CAO
- - [Control-plane selection](docs/control-planes.md): choose the Web UI, shell
- CLI, operations MCP server, or plugins.
- - [Web UI](docs/web-ui.md) and [MCP Apps](docs/mcp-apps.md): browser and
- host-rendered fleet interfaces.
- - [Kiro Crew](docs/kiro-crew.md): see, steer, start, and stop CAO sessions
- from the Kiro Crew dashboard with the CAO Shelf App, and remote control a
- session from a Kiro Crew chat.
- - [Flows](docs/flows.md) and [workflows](docs/workflows.md): scheduled runs and
- multi-step pipelines.
- - [Launch decisions](docs/decisions.md): local routing settings and content-free records.
- - [Skills](docs/skills.md): install, scope, and author reusable agent guidance.
- - [Skills lifecycle example](examples/skills/README.md): install, discover,
- load, apply, update, and remove a reusable skill in an isolated home.
- - [Memory](docs/memory.md) and [self-learning](docs/self-learning.md):
- persistent cross-session memory, and the opt-in loop that turns workflow
- outcomes into lessons and promoted instructions.
- - [AI-DLC portfolio example](examples/aidlc-portfolio/README.md): coordinate
- parallel AI-DLC intents across repositories and isolated worktrees.
- - [Cross-zone robot transport](examples/robotics/cross-zone-transport/README.md):
- coordinate simulated transport, measured custody handoffs, and independent checks.
- - [Hierarchical robot factory](examples/robotics/hierarchical-factory/README.md):
- a supervisor and three team-manager agents run nine Open Duck Mini robots on a
- simulated make, assemble, and ship line, and balance its bottleneck.
- - [Self-hosted decision model](examples/decision-model-host/README.md): run the open
- JevK5-4B decision model locally or on AWS (CDK), behind a loopback-only `/v1/systemone` API.
- - [Tool restrictions](docs/tool-restrictions.md): roles, allowlists, and
- provider enforcement.
- - [Kubernetes deployment](examples/cao-clusters/kubernetes/eks/README.md): run a supervisor and worker fleet on
- Amazon EKS, with shared workspace, per-pod state, and credential delivery.
- - [Updating CAO](docs/updating.md): update an installed uv tool.
- - [Remote CAO](docs/remote.md): run CAO on one always-on EC2 box and reach it from your laptop.
- ### Configure and integrate
- - [Ephemeral agents](docs/ephemeral-agents.md): opt-in, single-use helper agents that another agent creates
- and launches, and their limits.
- - [Ephemeral agents setup runbook](docs/ephemeral-agents-agent-setup.md): step-by-step setup of
- ephemeral agents and a decider, written for an agent to follow.
- - [Agent profiles](docs/agent-profile.md): profile schema, discovery, provider
- selection, and overrides.
- - [HTTP API and PTY WebSocket](docs/api.md): route-family overview and terminal
- streaming contract.
- - [Agent plugins](docs/agent-plugins.md): installing portable Agent Plugins
- 1.0.0 packages, and CAO's own operator and contributor packages. Every
- surface — the CLI, TUI, web panel, and the `/plugins*` HTTP routes — is built
- but **gated off by default** pending a naming decision. Set
- `CAO_AGENT_PLUGINS_ENABLED` to open it; until then the routes answer `404`,
- exactly as an unregistered path would. CAO's own packages also install without
- that gate from the repository's marketplace catalogs:
- `/plugin marketplace add awslabs/cli-agent-orchestrator` in Claude Code, or
- `codex plugin marketplace add awslabs/cli-agent-orchestrator` in Codex
- ([details](docs/agent-plugins.md#install-from-the-marketplace)).
- - [Event plugins](docs/plugins.md): outbound events, installation, and authoring.
- - Provider behavior:
- [Kiro CLI](docs/kiro-cli.md), [Claude Code](docs/claude-code.md),
- [Codex CLI](docs/codex-cli.md), [Antigravity CLI](docs/antigravity-cli.md),
- [Hermes](docs/hermes.md), [Kimi CLI](docs/kimi-cli.md),
- [Qwen Code](docs/qwen-cli.md),
- [MiniMax Code](docs/minimax-code.md),
- [GitHub Copilot CLI](docs/copilot-cli.md),
- [OpenCode CLI](docs/opencode-cli.md), [Oh My Pi(OMP) CLI](docs/omp-cli.md),
- [Cursor CLI](docs/cursor-cli.md), and
- [Grok Build CLI](docs/grok-cli.md).
- - [Security policy](SECURITY.md): vulnerability reporting and deployment
- guidance.
- ### Contribute
- - [Codebase guide](CODEBASE.md): runtime surfaces, package ownership, and data
- flow.
- - [Development guide](DEVELOPMENT.md): local setup, testing, and verification.
- - [Release guide](docs/RELEASING.md): maintainer release process.
- ## Contributing
- See [CONTRIBUTING.md](CONTRIBUTING.md) and [DEVELOPMENT.md](DEVELOPMENT.md)
- before submitting changes. Documentation changes must also follow the
- [documentation maintenance rule](CODEBASE.md#documentation-maintenance).
- ## License
- This project is licensed under the Apache License 2.0. See
- [LICENSE](LICENSE).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.