# `cao` — a CAO Agent Plugin

Drive CLI Agent Orchestrator multi-agent sessions from any Agent-Plugins-compatible client. Prerequisites: the `uv` toolchain must be on PATH (the MCP server is launched via `uvx`), and a CAO API server must be running locally at http://127.0.0.1:9889 (`cao-server`). All communication is localhost-only.

Generated by `scripts/build_agent_plugin.py` from the canonical skills in
`skills/`. Do not edit by hand — `make check-agent-plugin` fails on drift.

## Install

Installing an agent plugin runs untrusted code and content from its source. This
package comes from the CAO repository itself, but the same statement applies to
every plugin you install from anywhere.

From a clone:

```bash
cao plugin add ./agent-plugin/cao
```

From GitHub, without cloning:

```bash
cao plugin add https://github.com/awslabs/cli-agent-orchestrator --subdir agent-plugin/cao
```

Any Agent-Plugins-compatible client can install this directory the same way.

## Contents

Version `2.5.0`, synced from CAO's package metadata.

- `cao-session-management`
- `cao-agent-routing`
- `cao-supervisor-protocols`
- `cao-worker-protocols`

See [docs/agent-plugins.md](../../docs/agent-plugins.md) for the prerequisites
and the localhost-only posture.