$npx -y skills add AgentWrapper/agent-orchestrator --skill using-aoCatalog of the AO (Agent Orchestrator) ao CLI: spawning workers, managing sessions and projects, sending messages, previewing pages, and daemon control. Use when using the ao CLI, spawning workers, or managing AO sessions in an AO workspace.
| 1 | # AO CLI Catalog |
| 2 | |
| 3 | `ao` is a thin CLI over the local AO daemon. Every command is `ao <command> --help` for the authoritative flag list. |
| 4 | |
| 5 | | Command | What it does | When to use | Details | |
| 6 | |---|---|---|---| |
| 7 | | `spawn` | Spawn a worker agent in a fresh git worktree | Starting a new task or issue | [commands/spawn.md](commands/spawn.md) | |
| 8 | | `session` | Manage agent sessions (list, kill, rename, restore, etc.) | Inspecting or controlling running/terminated sessions | [commands/session.md](commands/session.md) | |
| 9 | | `project` | Register, inspect, configure, or remove projects | Setting up or managing repos AO knows about | [commands/project.md](commands/project.md) | |
| 10 | | `orchestrator` | List orchestrator sessions | Viewing which sessions are orchestrators | [commands/orchestrator.md](commands/orchestrator.md) | |
| 11 | | `review` | Submit a reviewer result for a worker's PR | Completing a code review loop | [commands/review.md](commands/review.md) | |
| 12 | | `send` | Send a message to a running agent session | Correcting or directing a live agent | [commands/send.md](commands/send.md) | |
| 13 | | `preview` | Open a URL in the desktop browser panel | Demoing a local server or file from inside a session | [commands/preview.md](commands/preview.md) | |
| 14 | | `start` | Fetch (if needed) and open the AO desktop app | Launching the app | [commands/start.md](commands/start.md) | |
| 15 | | `stop` | Stop the AO daemon | Shutting down AO | [commands/stop.md](commands/stop.md) | |
| 16 | | `status` | Show daemon status | Verifying the daemon is up and healthy | [commands/status.md](commands/status.md) | |
| 17 | | `doctor` | Run local health checks | Diagnosing AO setup problems | [commands/doctor.md](commands/doctor.md) | |
| 18 | | `import` | Import projects from a legacy AO install | Migrating from the old flat-file store | [commands/import.md](commands/import.md) | |
| 19 | | `version` | Print version information | Checking installed version | - | |
| 20 | | `completion` | Generate shell completion scripts | Setting up tab completion | - | |
| 21 | |
| 22 | ## Conventions |
| 23 | |
| 24 | - Most read commands accept `--json` for machine-readable output. |
| 25 | - `-p / --project` scopes session subcommand lookups to one project. |
| 26 | - Session and project ids are shown by `ao session ls` and `ao project ls`. |
| 27 | - `--agent` is an alias for `--harness` on `ao spawn`. |
| 28 | - Every command accepts `-h / --help` for the full flag list. |
| 29 | |
| 30 | See [references.md](references.md) for natural-language-to-command mappings. |