Skip to content

CLI.md

Latest commit

 

History

History
41 lines (31 loc) · 2.25 KB

CLI.md

File metadata and controls

41 lines (31 loc) · 2.25 KB

AO CLI Reference

The ao CLI is the control interface for Agent Orchestrator. Most commands are used by the orchestrator agent itself to manage sessions, not by humans directly. Humans typically only need ao start and the web dashboard.

Commands humans use

ao start                               # Auto-detect, generate config, start dashboard + orchestrator
ao start <url>                         # Clone repo, auto-configure, and start
ao start ~/other-repo                  # Add a new project and start
ao stop                                # Stop everything (dashboard, orchestrator, lifecycle worker)
ao status                              # Overview of all sessions
ao dashboard                           # Open web dashboard in browser

Commands the orchestrator agent uses

These are primarily invoked by the orchestrator agent running inside a tmux session. You can use them manually if needed, but the orchestrator handles this automatically.

ao spawn [issue]                       # Spawn an agent (project auto-detected from cwd)
ao spawn 123 --agent codex             # Override agent for this session
ao batch-spawn 101 102 103             # Spawn agents for multiple issues at once
ao send <session> "Fix the tests"      # Send instructions to a running agent
ao session ls                          # List sessions
ao session kill <session>              # Kill a session
ao session restore <session>           # Revive a crashed agent

Maintenance commands

ao doctor                              # Check install, runtime, and stale temp issues
ao doctor --fix                        # Apply safe fixes automatically
ao update                              # Update local AO install (source installs only)
ao config-help                         # Show full config schema reference

ao doctor checks PATH and launcher resolution, required binaries, tmux and GitHub CLI health, config support directories, stale AO temp files, and core build/runtime sanity.

ao update fast-forwards the local install on main, reinstalls dependencies, clean-rebuilds core packages, refreshes the launcher, and runs smoke tests. Use ao update --skip-smoke to stop after rebuild, or ao update --smoke-only to rerun just the smoke checks.