Skip to content
FunCoding

using-ao

Catalog of the AO (Agent Orchestrator) `ao` CLI: spawning workers, managing sessions and projects, creating reusable Cues, sending messages, controlling the shared browser, previewing pages, and daemon control. Use when using the ao CLI, creating Cues, spawning workers, or managing AO sessions in an AO workspace.

Star
13,116
License
Apache-2.0
Last commit
Oct 13, 2026

backend/internal/skillassets/using-ao/SKILL.md

View on GitHub

AO CLI Catalog

ao is a thin CLI over the local AO daemon. Every command is ao <command> --help for the authoritative flag list.

CommandWhat it doesWhen to useDetails
spawnSpawn a project worker, orchestrator, or projectless standalone workerStarting a new task or issuecommands/spawn.md
sessionManage agent sessions (list, kill, rename, restore, etc.)Inspecting or controlling running/terminated sessionscommands/session.md
agentInspect installed harnesses and launch readinessChoosing or diagnosing an agent harnessao agent ls --refresh
prMerge a PR or resolve its review threadsCompleting a reviewed changeao pr merge / ao pr resolve-comments
projectRegister, inspect, configure, or remove projectsSetting up or managing repos AO knows aboutcommands/project.md
automationManage durable recurring session automationsCreating, editing, disabling, deleting, and inspecting scheduled runscommands/automation.md
cueCreate or list reusable project CuesSaving a repetitive command or agent task at the user's requestcommands/cue.md
orchestratorList orchestrator sessionsViewing which sessions are orchestratorscommands/orchestrator.md
reviewStart, list, cancel, or submit AO's native reviewer for a worker's PR (default: this session)Getting an adversarial review of an AO session's PR; never spawn a worker to reviewcommands/review.md
sendSend a message to a running agent sessionCorrecting or directing a live agentcommands/send.md
reportPersist a meaningful worker reportCheckpoints, blockers, decisions, outputs, and completioncommands/report.md
previewStart a session-owned app or open an exact URL/fileRunning and showing the worker's relevant app, Markdown, HTML, PDF, or imagecommands/preview.md
renderShow a self-contained HTML page inline in a chat threadAnswering with a chart, table, diagram, or mockupcommands/render.md
browserInspect and control the session's shared live browserVerifying a web app through snapshots, interactions, waits, screenshots, console, and errorscommands/browser.md
startFetch (if needed) and open the AO desktop appLaunching the appcommands/start.md
stopStop the AO daemonShutting down AOcommands/stop.md
statusShow daemon statusVerifying the daemon is up and healthycommands/status.md
doctorRun local health checksDiagnosing AO setup problemscommands/doctor.md
importImport projects from a legacy AO installMigrating from the old flat-file storecommands/import.md
versionPrint version informationChecking installed version-
completionGenerate shell completion scriptsSetting up tab completion-

Conventions

  • Most read commands accept --json for machine-readable output.
  • -p / --project scopes session subcommand lookups to one project.
  • Session and project ids are shown by ao session ls and ao project ls.
  • To refer to a session in AO Chat or the AO terminal, use the canonical in-app link ao://sessions/{project-id}/{session-id}. Read commands/session.md for identity, encoding, and safety rules before constructing one.
  • When the user asks to save a repeatable task as a Cue, use ao cue list --json to check existing definitions, then ao cue create. An agent Cue stores a reusable instruction; a command Cue stores an exact shell command. This agent-facing command can create and read Cues, but cannot edit or delete them. Direct the user to project settings for changes to existing Cues.
  • --agent is an alias for --harness on ao spawn.
  • Every command accepts -h / --help for the full flag list.
  • For frontend launch, preview selection, or artifact handoff, read commands/preview.md before acting. Its static-file, project-runtime, and automatic-handoff rules are load-bearing.
  • For page inspection, interaction, or request diagnosis, read commands/browser.md. It defines shared-tab behavior and the opt-in network policy.

Use references.md only when a natural-language request does not map clearly to a command above.

Similar Skills

test-driven-development

OBobra/superpowers298k2,631 new stars in the last 7 days

migrate-to-shoehorn

MAmattpocock/skills288k10,178 new stars in the last 7 days

agent-runtime-gateway-smoke-test

AFaffaan-m/ECC278k4,046 new stars in the last 7 days

Featured

accessibility

Audit accessibility on Web, iOS, and Android to meet WCAG 2.2, with keyboard navigation and screen-reader support.

AFaffaan-m/ECC278k4,046 new stars in the last 7 days

ai-regression-testing

AFaffaan-m/ECC278k4,046 new stars in the last 7 days

Official

firecrawl-build-interact

FIfirecrawl/firecrawl191k2,010 new stars in the last 7 days