Skip to content
Back to search

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.

Checked yesterday

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/awslabs--cli-agent-orchestrator/badge.svg)](/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

i

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.

  1. <!-- An absolute raw URL, not a repo-relative path: this file is also the PyPI
  2. long description (see `readme` in pyproject.toml) and PyPI cannot resolve
  3. relative paths.
  4. The banner is used rather than the bare mark because it supplies its own
  5. background, so the mark's navy never has to survive a backdrop it cannot
  6. see. The bare mark would need a <picture>/prefers-color-scheme swap, since
  7. that navy contrasts at only 1.77:1 on GitHub's dark theme, and PyPI allows
  8. <img> but not <picture>, so that markup would either be dropped or escaped
  9. into visible tag soup depending on how it sanitizes.
  10. The same constraint means the banner cannot be swapped per theme either.
  11. It is light, matching PyPI and GitHub's light theme, and it shows as a
  12. bright panel on GitHub's dark theme. That is a deliberate trade, not an
  13. oversight. Keep in sync with README.zh-CN.md. -->
  14. <p align="center">
  15. <img src="https://raw.githubusercontent.com/awslabs/cli-agent-orchestrator/main/docusaurus/static/img/cao-social-card.png"
  16. alt="" width="640">
  17. </p>
  18. # CLI Agent Orchestrator (CAO)
  19. [English](README.md) | [简体中文](README.zh-CN.md)
  20. [![PyPI version](https://img.shields.io/pypi/v/cli-agent-orchestrator.svg)](https://pypi.org/project/cli-agent-orchestrator/)
  21. [![Python versions](https://img.shields.io/pypi/pyversions/cli-agent-orchestrator.svg)](https://pypi.org/project/cli-agent-orchestrator/)
  22. [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/awslabs/cli-agent-orchestrator)
  23. **CLI Agent Orchestrator (CAO)** coordinates multiple AI coding CLIs so a
  24. supervisor can delegate work to specialist agents in parallel or sequence.
  25. 📚 **[Documentation](https://awslabs.github.io/cli-agent-orchestrator/)** —
  26. guides, reference, and two interactive courses.
  27. ## What CAO does
  28. CAO runs a local `cao-server`, starts provider CLIs in isolated terminal
  29. sessions, and gives a supervisor tools for coordinating workers. The agents
  30. remain full CLI processes with their native authentication and capabilities.
  31. See [CODEBASE.md](CODEBASE.md) for the runtime architecture and package layout.
  32. ## Prerequisites
  33. Install:
  34. - Python 3.11 or later
  35. - tmux 3.3 or later
  36. - [uv](https://docs.astral.sh/uv/)
  37. - At least one supported provider CLI, authenticated before you launch CAO:
  38. [Kiro CLI](docs/kiro-cli.md), [Claude Code](docs/claude-code.md),
  39. [Codex CLI](docs/codex-cli.md), [Antigravity CLI](docs/antigravity-cli.md),
  40. [Hermes](docs/hermes.md), [Kimi CLI](docs/kimi-cli.md),
  41. [Qwen Code](docs/qwen-cli.md),
  42. [MiniMax Code](docs/minimax-code.md),
  43. [GitHub Copilot CLI](docs/copilot-cli.md),
  44. [OpenCode CLI](docs/opencode-cli.md), [Oh My Pi(OMP) CLI](docs/omp-cli.md),
  45. [Cursor CLI](docs/cursor-cli.md), or
  46. [Grok Build CLI](docs/grok-cli.md)
  47. The focused provider guides contain installation, authentication, and
  48. provider-specific behavior.
  49. ## Install CAO
  50. Install the current `main` branch as a uv tool:
  51. ```bash
  52. uv tool install git+https://github.com/awslabs/cli-agent-orchestrator.git@main --upgrade
  53. cao --help
  54. ```
  55. For a tagged release, install
  56. [`cli-agent-orchestrator` from PyPI](https://pypi.org/project/cli-agent-orchestrator/).
  57. See [DEVELOPMENT.md](DEVELOPMENT.md) for a source checkout.
  58. For container-based installation, see the
  59. [devcontainer feature](docs/devcontainer-feature.md).
  60. To update an existing CAO installation:
  61. ```bash
  62. cao update
  63. ```
  64. See [Updating CAO](docs/updating.md) for source-aware behavior and edge cases.
  65. ## First supervisor launch
  66. The unqualified commands below use CAO's default Kiro CLI provider. If you
  67. installed a different provider, follow its focused guide above for the
  68. provider override while keeping the same sequence.
  69. 1. Install the built-in supervisor profile:
  70. ```bash
  71. cao install code_supervisor
  72. ```
  73. 2. In terminal A, start the local server and leave it running:
  74. ```bash
  75. cao-server
  76. ```
  77. 3. In terminal B, change to the project directory the agents should work in,
  78. then launch the supervisor:
  79. ```bash
  80. cd /path/to/your/project
  81. cao launch --agents code_supervisor
  82. ```
  83. 4. Observe the supervisor in the attached launch terminal, open the
  84. [Web UI](docs/web-ui.md) at `http://localhost:9889`, or follow the
  85. [tmux guide](docs/tmux.md) to attach to its session.
  86. 5. Stop the named session when finished:
  87. ```bash
  88. cao shutdown --session {session-name}
  89. ```
  90. To stop every CAO session instead, run `cao shutdown --all`.
  91. ## Where to go next
  92. ### Operate CAO
  93. - [Control-plane selection](docs/control-planes.md): choose the Web UI, shell
  94. CLI, operations MCP server, or plugins.
  95. - [Web UI](docs/web-ui.md) and [MCP Apps](docs/mcp-apps.md): browser and
  96. host-rendered fleet interfaces.
  97. - [Kiro Crew](docs/kiro-crew.md): see, steer, start, and stop CAO sessions
  98. from the Kiro Crew dashboard with the CAO Shelf App, and remote control a
  99. session from a Kiro Crew chat.
  100. - [Flows](docs/flows.md) and [workflows](docs/workflows.md): scheduled runs and
  101. multi-step pipelines.
  102. - [Launch decisions](docs/decisions.md): local routing settings and content-free records.
  103. - [Skills](docs/skills.md): install, scope, and author reusable agent guidance.
  104. - [Skills lifecycle example](examples/skills/README.md): install, discover,
  105. load, apply, update, and remove a reusable skill in an isolated home.
  106. - [Memory](docs/memory.md) and [self-learning](docs/self-learning.md):
  107. persistent cross-session memory, and the opt-in loop that turns workflow
  108. outcomes into lessons and promoted instructions.
  109. - [AI-DLC portfolio example](examples/aidlc-portfolio/README.md): coordinate
  110. parallel AI-DLC intents across repositories and isolated worktrees.
  111. - [Cross-zone robot transport](examples/robotics/cross-zone-transport/README.md):
  112. coordinate simulated transport, measured custody handoffs, and independent checks.
  113. - [Hierarchical robot factory](examples/robotics/hierarchical-factory/README.md):
  114. a supervisor and three team-manager agents run nine Open Duck Mini robots on a
  115. simulated make, assemble, and ship line, and balance its bottleneck.
  116. - [Self-hosted decision model](examples/decision-model-host/README.md): run the open
  117. JevK5-4B decision model locally or on AWS (CDK), behind a loopback-only `/v1/systemone` API.
  118. - [Tool restrictions](docs/tool-restrictions.md): roles, allowlists, and
  119. provider enforcement.
  120. - [Kubernetes deployment](examples/cao-clusters/kubernetes/eks/README.md): run a supervisor and worker fleet on
  121. Amazon EKS, with shared workspace, per-pod state, and credential delivery.
  122. - [Updating CAO](docs/updating.md): update an installed uv tool.
  123. - [Remote CAO](docs/remote.md): run CAO on one always-on EC2 box and reach it from your laptop.
  124. ### Configure and integrate
  125. - [Ephemeral agents](docs/ephemeral-agents.md): opt-in, single-use helper agents that another agent creates
  126. and launches, and their limits.
  127. - [Ephemeral agents setup runbook](docs/ephemeral-agents-agent-setup.md): step-by-step setup of
  128. ephemeral agents and a decider, written for an agent to follow.
  129. - [Agent profiles](docs/agent-profile.md): profile schema, discovery, provider
  130. selection, and overrides.
  131. - [HTTP API and PTY WebSocket](docs/api.md): route-family overview and terminal
  132. streaming contract.
  133. - [Agent plugins](docs/agent-plugins.md): installing portable Agent Plugins
  134. 1.0.0 packages, and CAO's own operator and contributor packages. Every
  135. surface — the CLI, TUI, web panel, and the `/plugins*` HTTP routes — is built
  136. but **gated off by default** pending a naming decision. Set
  137. `CAO_AGENT_PLUGINS_ENABLED` to open it; until then the routes answer `404`,
  138. exactly as an unregistered path would. CAO's own packages also install without
  139. that gate from the repository's marketplace catalogs:
  140. `/plugin marketplace add awslabs/cli-agent-orchestrator` in Claude Code, or
  141. `codex plugin marketplace add awslabs/cli-agent-orchestrator` in Codex
  142. ([details](docs/agent-plugins.md#install-from-the-marketplace)).
  143. - [Event plugins](docs/plugins.md): outbound events, installation, and authoring.
  144. - Provider behavior:
  145. [Kiro CLI](docs/kiro-cli.md), [Claude Code](docs/claude-code.md),
  146. [Codex CLI](docs/codex-cli.md), [Antigravity CLI](docs/antigravity-cli.md),
  147. [Hermes](docs/hermes.md), [Kimi CLI](docs/kimi-cli.md),
  148. [Qwen Code](docs/qwen-cli.md),
  149. [MiniMax Code](docs/minimax-code.md),
  150. [GitHub Copilot CLI](docs/copilot-cli.md),
  151. [OpenCode CLI](docs/opencode-cli.md), [Oh My Pi(OMP) CLI](docs/omp-cli.md),
  152. [Cursor CLI](docs/cursor-cli.md), and
  153. [Grok Build CLI](docs/grok-cli.md).
  154. - [Security policy](SECURITY.md): vulnerability reporting and deployment
  155. guidance.
  156. ### Contribute
  157. - [Codebase guide](CODEBASE.md): runtime surfaces, package ownership, and data
  158. flow.
  159. - [Development guide](DEVELOPMENT.md): local setup, testing, and verification.
  160. - [Release guide](docs/RELEASING.md): maintainer release process.
  161. ## Contributing
  162. See [CONTRIBUTING.md](CONTRIBUTING.md) and [DEVELOPMENT.md](DEVELOPMENT.md)
  163. before submitting changes. Documentation changes must also follow the
  164. [documentation maintenance rule](CODEBASE.md#documentation-maintenance).
  165. ## License
  166. This project is licensed under the Apache License 2.0. See
  167. [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.