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.
$ npx -y skills add awslabs/cli-agent-orchestrator --agent claude-code
Run the curl in your terminal, the rest in Claude Code.
What's inside
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.
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.
Install:
The focused provider guides contain installation, authentication, and provider-specific behavior.
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.
See DEVELOPMENT.md for a source checkout.
For container-based installation, see the
devcontainer feature.
To update an existing CAO installation:
cao update
See Updating CAO for source-aware behavior and edge cases.
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.
Install the built-in supervisor profile:
cao install code_supervisor
In terminal A, start the local server and leave it running:
cao-server
In terminal B, change to the project directory the agents should work in, then launch the supervisor:
cd /path/to/your/project
cao launch --agents code_supervisor
Observe the supervisor in the attached launch terminal, open the
Web UI at http://localhost:9889, or follow the
tmux guide to attach to its session.
Stop the named session when finished:
cao shutdown --session {session-name}
To stop every CAO session instead, run cao shutdown --all.
See CONTRIBUTING.md and DEVELOPMENT.md before submitting changes. Documentation changes must also follow the documentation maintenance rule.
This project is licensed under the Apache License 2.0. See LICENSE.
.coverage-baseline.json
.devcontainer/
features/
cao/
devcontainer-feature.json
install.sh
.github/
ISSUE_TEMPLATE/
feature_request.md
workflows/
cargo-deny.yml
ci.yml
gh-pages.yml
publish-to-pypi.yml
release.yml
secret-scan.yml
test-antigravity-cli-provider.yml
test-claude-code-provider.yml
test-codex-provider.yml
test-kiro-cli-provider.yml
.gitignore
.gitleaks.toml
.pre-commit-config.yaml
.tmux.conf
cao_mcp_apps/
.gitignore
.husky/
pre-commit
pre-push
e2e/
agent.spec.ts
dashboard.spec.ts
event-stream.spec.ts
host.html
host.js
server.mjs
package-lock.json
package.json
playwright.config.ts
README.md
scripts/
check-bundle-size.mjs
coverage-ratchet.mjs
record-demo.mjs
scan-jit.mjs
src/
agent/
agent.html
AgentView.tsx
main.tsx
dashboard/
dashboard.html
Dashboard.tsx
main.tsx
event-stream/
event-stream.html
EventStreamView.tsx
main.tsx
graph/
graph.html
GraphView.test.tsx
GraphView.tsx
main.tsx
types.ts
shared/
AgentStatus.tsx
EventStream.tsx
HeaderBar.tsx
mcpApp.ts
patch.test.ts
patch.ts
patchOps.test.ts
status.generated.ts
styles.css
TaskControl.tsx
tokens.generated.css
types.ts
test/
__snapshots__/
layout.test.tsx.snap
component.test.tsx
design-tokens-parity.test.ts
gesture.test.tsx
hostActions.test.tsx
integration.test.tsx
layout.test.tsx
lifecycle.test.tsx
mockHost.ts
setup.ts
tsconfig.json
vite.config.agent.ts
vite.config.dashboard.ts
vite.config.events.ts
vite.config.graph.ts
vite.config.ts
vitest.config.ts
CHANGELOG.md
cliff.toml
CODE_OF_CONDUCT.md
CODEBASE.md
CONTRIBUTING.md
design-tokens/
gen.mjs
status.json
tokens.json
DEVELOPMENT.md
docs/
agent-profile.md
agui.md
antigravity-cli.md
api.md
assets/
cao_architecture.mmd
cao_architecture.png
handoff-workflow.mmd
handoff-workflow.png
multi-role-feature-development.mmd
multi-role-feature-development.png
parallel-data-analysis.mmd
parallel-data-analysis.png
parallel-test-execution.mmd
parallel-test-execution.png
tmux_all_windows.png
claude-code.md
codespaces.md
codex-cli.md
configuration.md
control-planes.md
copilot-cli.md
cursor-cli.md
devcontainer-feature.md
discovery-tool-coexistence.md
event-driven-architecture.md
examples/
conditional_example.py
fanout_example.py
loop_example.py
loop_raw_http_example.py
external-tool-integration.md
fleet-coordinator.md
flows.md
herdr.md
hermes.md
inbox-delivery.md
issues/
345-okf-export-import/
design.md
568-js-yaml-omap-dos/
design.md
requirements.md
tasks.md
kimi-cli.md
kiro-cli.md
knowledge-graph-viewing.md
mcp-apps.md
media/
ag-ui-copilotkit-demo.gif
ag-ui-cross-provider-sync-demo.gif
ag-ui-eventsource-viewer-demo.gif
ag-ui-handoff-approval-demo.gif
ag-ui-session-timeline-demo.gif
ag-ui-supervisor-dashboard-demo.gif
mcp-apps-agent.png
mcp-apps-dashboard.png
mcp-apps-demo.gif
mcp-apps-demo.mp4
mcp-apps-demo.webm
mcp-apps-event-stream.png
memory.md
mock-cli-provider.md
opencode-cli.md
otel-deployment.md
plugins.md
RELEASING.md
security.md
self-learning-validation.md
self-learning.md
settings.md
skills.md
superpowers/
plans/
2026-07-22-herdr-integration-modernization.md
terminal-lifecycle.md
tmux.md
tool-restrictions.md
updating.md
web-ui.md
workflow-scripts-authoring-guide.md
workflows.md
working-directory.md
docusaurus/
.gitignore
course-src/
advanced/
_base.html
_footer.html
modules/
01-event-pipeline.html
02-workflows.html
03-skills-install.html
04-automation-ops.html
build.sh
fundamentals/
_base.html
_footer.html
modules/
01-what-cao-does.html
02-cast-of-characters.html
03-how-agents-talk.html
04-running-your-own.html
shared/
main.js
styles.css
docs/
core-concepts/
architecture.md
orchestration-patterns.md
sessions.md
features/
mcp-server.md
multi-provider.md
profiles.md
scheduled-flows.md
web-ui.md
getting-started/
installation.md
quick-start.md
guides/
building-with-claude-code.md
building-with-kiro.md
intro.md
patterns/
assign.md
handoff.md
send-message.md
reference/
cli-commands.md
configuration.md
environment-variables.md
docusaurus.config.ts
package-lock.json
package.json
README.md
sidebars.ts
src/
css/
custom.css
pages/
index.module.css
index.tsx
static/
.nojekyll
img/
favicon.ico
logo.svg
tsconfig.json
examples/
ag-ui/
ag-ui-construct-demos/
tools/
.gitignore
package-lock.json
package.json
README.md
record-construct-demos.mjs
ag-ui-cross-provider-sync/
README.md
run.sh
ag-ui-dashboard/
fleet_worker.md
README.md
run.sh
showcase.sh
ag-ui-eventsource-viewer/
index.html
README.md
tools/
.gitignore
package-lock.json
package.json
record-demo.mjs
ag-ui-handoff-approval/
README.md
run.sh
ag-ui-meta-dogfood/
capture.py
dashboard.json
frames.jsonl
README.md
run.sh
timeline.json
ag-ui-session-timeline/
README.md
run.sh
ag-ui-stock-client-live/
.gitignore
client.mjs
package-lock.json
package.json
README.md
run.sh
ag-ui-supervisor-dashboard/
README.md
run.sh
README.md
aidlc-portfolio/
.gitignore
aidlc_portfolio_supervisor.md
aidlc_runner.md
bun.lock
package.json
README.md
skills/
aidlc-portfolio/
agents/
openai.yaml
assets/
schemas/
child-result.schema.json
dependency.schema.json
discovery-decision.schema.json
intent.schema.json
learning-proposal.schema.json
portfolio.schema.json
project.schema.json
templates/
child-result.yaml
dependency.yaml
discovery-decision.yaml
intent.yaml
learning-proposal.yaml
portfolio-questions.md
portfolio.yaml
project.yaml
question-packet.md
runner-message.md
bun.lock
package.json
references/
catalog-model.md
convergence.md
coordination-rules.md
harness-lifecycle.md
portfolio-lifecycle.md
shared-memory.md
scripts/
convergence.ts
harness.ts
lib.ts
portfolio.ts
SKILL.md
tests/
convergence.test.ts
harness.test.ts
lifecycle.test.ts
portfolio.test.ts
tsconfig.json
assign/
analysis_supervisor.md
data_analyst.md
README.md
report_generator.md
aws/
cloudwatch-logs/
cloudwatch-logs-agent.md
config.json
dynamodb-delete/
config.json
dynamodb-delete-agent.md
dynamodb-query/
config.json
dynamodb-query-agent.md
README.md
sqs-dlq-check/
config.json
sqs-dlq-check-agent.md
sqs-monitor/
config.json
sqs-monitor-agent.md
sqs-send/
config.json
sqs-send-agent.md
stepfunction/
config.json
stepfunction-agent.md
codex-basic/
codex_developer.md
codex_documenter.md
codex_reviewer.md
README.md
cross-provider/
cross_provider_supervisor.md
data_analyst_claude_code.md
data_analyst_codex.md
data_analyst_copilot_cli.md
data_analyst_kimi_cli.md
data_analyst_kiro_cli.md
README.md
report_generator_codex.md
fleet/
... 978 moreRead this in other languages: ๆฅๆฌ่ช Generative AI can make mistakes. You should consider reviewing all output and costs generated by your chosen AI model and agentic coding assistant. See AWS Responsible AI Policy.
@awslabsFAQ
cli-agent-orchestrator is a Claude Code plugin with 28 hand-picked skills for automation work, indexed on Flowy. Install it with the command on its page. It includes agui-author, cao-agent-routing, cao-learning. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.