Coordinate AO Cloud work sessions through the ao command line. Create and monitor workers, exchange messages, attach pull requests, start reviews, and operate the visible browser using the commands available to each session’s role.
Catalog of the AO Cloud `ao` CLI available inside a cloud sandbox: spawning worker sessions, listing them, messaging them, reporting to the orchestrator, killing them, claiming pull requests, and starting AO reviews. Use when orchestrating or coordinating AO cloud sessions with the ao CLI.
Review the instructions the agent will receive before you install.
ao inside a cloud sandbox is a thin client over the AO control plane. It is a
different, smaller CLI than the desktop ao: there is no ao session,
ao project, ao status, or ao preview here. Every command is
ao help for the authoritative list.
| Command | What it does | Who can run it | Details |
|---|---|---|---|
spawn | Create a worker session in its own fresh sandbox | Orchestrators only | commands/orchestration.md |
list (ls, status) | List the workers this orchestrator spawned, with branch, status, and PR facts | Orchestrators only | commands/orchestration.md |
send | Send a message into a worker's conversation | Orchestrators only | commands/orchestration.md |
kill (delete, rm) | Terminate a worker session and its sandbox | Orchestrators only | commands/orchestration.md |
report | Send a message to the orchestrator that spawned this session | Workers with an orchestrator parent | commands/orchestration.md |
claim-pr | Attach an existing pull request to this session | Any session | commands/pull-requests.md |
review trigger | Start AO's reviewer on this session's open pull requests | Any session | commands/pull-requests.md |
browser | Run agent-browser commands (open, snapshot, click, fill, screenshot, ...) in a browser the person sees and can use in AO's Browser panel | Sandboxes with a browser | ao help |
ao list --json prints machine-readable output; --all includes terminated
workers (hidden by default).--agent is an alias for --harness on ao spawn.ao list.ao commands
above are the only channel between sessions.send to a worker whose sandbox is still provisioning is queued by the
control plane and delivered when the worker's agent is ready — check
runtimeConnected in ao list --json to see whether a worker is live.ao.No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Launch and troubleshoot the actual AO desktop app to inspect interface changes with local data. Supports reviewing combined pull request branches and diagnosing lingering Electron processes, port conflicts, and mismatches in the app’s preload bridge.
Helps clarify bug reports written by people, search for duplicate reports, and collect diagnostic evidence. Keeps investigation material separate from a concise issue draft, with the detailed workflow defined in a referenced file.
Calculates added and deleted lines for a pull request and maintains a three-line summary for implementation, tests, and other files. Preserves existing description text and checks the published counts against the current diff.
Helps you use the AO command line to launch agents, manage work sessions and projects, and save reusable tasks as Cues. Also covers agent messaging, shared browser controls, previews, and local service checks.