ao CLI Command Surface

July 11, 2026 ยท View on GitHub

Generated by scripts/check-cmdao-surface-parity.sh --write-surface. Do not edit command rows manually.

CommandCategoryCoverageReason
ao beads auditpublic-stateful-fixture-neededallowlistedRequires a beads database fixture; auto-close mode mutates issue state.
ao beads clusterpublic-stateful-fixture-neededallowlistedRequires a beads database fixture; apply mode mutates issue parents.
ao beads dirpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao beads epic-statuspublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao beads execpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao beads harvestpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao beads lintpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao beads resumepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao beads scenarios extractpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao beads scenarios validatepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao beads stale-claimspublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao beads trackerpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao beads verifypublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao beads verify-acceptancepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao capabilitiespublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao claim bindpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao claim checkpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao claim listpublic-stateful-fixture-neededallowlistedReads claim-evidence stores and needs an isolated claim fixture.
ao closepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao completionpublic-testedallowlistedFramework completion root; subcommand generation has focused tests.
ao config modelspublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao council-gatepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao doctor capabilitiespublic-stateful-fixture-neededallowlistedInspects local installation capabilities and needs a controlled home/repo fixture.
ao doctor diffpublic-stateful-fixture-neededallowlistedCompares local installation state and needs a controlled home/repo fixture.
ao doctor explainpublic-stateful-fixture-neededallowlistedExplains doctor findings from local state and needs a controlled findings fixture.
ao doctor fixpublic-stateful-fixture-neededallowlistedMutates local installation state and needs an isolated repair fixture.
ao doctor gcpublic-stateful-fixture-neededallowlistedPrunes local doctor artifacts and needs an isolated artifact fixture.
ao doctor healthpublic-stateful-fixture-neededallowlistedInspects local health state and needs a controlled home/repo fixture.
ao doctor lspublic-stateful-fixture-neededallowlistedLists local doctor-managed artifacts and needs a controlled home/repo fixture.
ao doctor robot-docspublic-stateful-fixture-neededallowlistedGenerates robot docs from local state and needs a controlled output fixture.
ao doctor undopublic-stateful-fixture-neededallowlistedReverts doctor fixes and needs an isolated undo fixture.
ao donepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval baselinepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval baseline-auditpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval benchpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval chaospublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval cleanuppublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval comparepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval coveragepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval outcomes compilepublic-stateful-fixture-neededallowlistedHoldout-safe rubric projection; core logic unit-tested (eval_outcomes_test.go compileOutcomesRubric); CLI smoke needs an input.json fixture (follow-up).
ao eval outcomes ingestpublic-stateful-fixture-neededallowlistedMaps an Outcomes score to the council verdict record; core logic unit-tested (eval_outcomes_ingest_test.go ingestOutcomesScore); CLI smoke needs a score.json fixture (follow-up).
ao eval runpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval scenario addpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval scenario evaluatepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval scenario initpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval scenario listpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval scenario validatepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval scenario-abpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval scenario-moatpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval scorecardpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval session-outcomepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval suite n-requiredpublic-stateful-fixture-neededallowlistedComputes eval-suite thresholds and needs a representative suite fixture.
ao eval suite verdictpublic-stateful-fixture-neededallowlistedProjects eval-suite verdicts and needs a representative suite fixture.
ao eval task addpublic-stateful-fixture-neededallowlistedMutates eval task manifests and needs a disposable eval fixture.
ao eval task listpublic-stateful-fixture-neededallowlistedReads eval task manifests and needs a representative eval fixture.
ao eval task runpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao eval task showpublic-stateful-fixture-neededallowlistedReads eval task manifests and needs a representative eval fixture.
ao gate approvepublic-testedallowlistedCovered by gate command tests.
ao gate bulk-approvepublic-testedallowlistedCovered by gate command tests.
ao gate checkpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao gate pendingpublic-testedallowlistedCovered by gate command tests.
ao gate rejectpublic-testedallowlistedCovered by gate command tests.
ao gate runpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao goals addpublic-stateful-fixture-neededallowlistedWrites GOALS.md and needs an isolated goal fixture.
ao goals driftpublic-stateful-fixture-neededallowlistedRequires two goal snapshots to compare.
ao goals exportpublic-testedallowlistedCovered through goals measure snapshot behavior.
ao goals historypublic-testedallowlistedHistorical view shares goals validation behavior.
ao goals initpublic-stateful-fixture-neededallowlistedInitializes GOALS.md and may prompt in an existing repo.
ao goals measurepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao goals metapublic-testedallowlistedCovered through goals measure behavior.
ao goals migratepublic-stateful-fixture-neededallowlistedMigrates GOALS.md format and needs a disposable fixture.
ao goals prunepublic-stateful-fixture-neededallowlistedRemoves stale goal entries and needs a disposable fixture.
ao goals renderpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao goals scenariospublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao goals steer addpublic-stateful-fixture-neededallowlistedWrites GOALS.md and needs an isolated goal fixture.
ao goals steer applypublic-stateful-fixture-neededallowlistedMutates GOALS.md from steering recommendations and needs an isolated goal fixture.
ao goals steer prioritizepublic-stateful-fixture-neededallowlistedWrites GOALS.md and needs an isolated goal fixture.
ao goals steer recommendpublic-stateful-fixture-neededallowlistedReads goal history and needs a representative goal fixture.
ao goals steer removepublic-stateful-fixture-neededallowlistedWrites GOALS.md and needs an isolated goal fixture.
ao goals tracepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao goals validatepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao governor budgetpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao governor noise-bandpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao helpinternal-hiddenallowlistedBuilt-in Cobra help dispatcher with no application handler.
ao initpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao landpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao membrane calibratepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao membrane catchpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao membrane derive-checkspublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao membrane digestpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao membrane recallpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao membrane triagepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao pawl doctorpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao pawl downunsafe-liveallowlistedKills the live standing opus+codex ATM pawl-service; ao wrapper exit-code-tested (TestPawlServiceCmd); pawl.sh down live-proven (ml8.1).
ao pawl healthunsafe-liveallowlistedProbes a live standing ATM pawl-service; ao wrapper exit-code-tested; pawl.sh health live-proven.
ao pawl metricspublic-testedallowlistedRead-only SLO surface over recorded routes; covered by tests/scripts/pawl-metrics.bats (6 tests) + ao-wrapper exit-code test (TestPawlServiceCmd).
ao pawl reapunsafe-liveallowlistedConditionally tears down the live standing pawl-service iff idle > PAWL_IDLE_TTL (else no-op); ao wrapper exit-code-tested (TestPawlServiceCmd); pawl.sh reap idle-TTL logic unit-tested + cmd_down live-proven (age-4o33).
ao pawl reviewpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao pawl routeunsafe-liveallowlistedRoutes a packet to live opus+codex model panes (requires a standing service); ao wrapper exit-code-tested; pawl.sh route live-proven across 4 routes (ml8.2).
ao pawl smokepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao pawl uppublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao plan-pawl decidepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance addpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance emit-landedpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance emit-verdictpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance exportpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance ledger-reader-versionpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance listpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance mine-sessionpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance positionpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance reconcilepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance showpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance tracepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao provenance verifypublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao quick-startpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao readypublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao robot-docspublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao session bootstrappublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao session closepublic-testedallowlistedCovered by session close tests.
ao session handoffpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao session memory syncpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao session rehydratepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao session state admitpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao session state candidatepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao session state doctorpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao session state review-requestpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao session state validatepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao session state verifypublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao skills checkpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao skills consumerspublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao skills edit digestpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao skills edit sealpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao skills findpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao skills graphpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao skills linkpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao skills listpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao skills producerspublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao skills resolvepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao skills retirepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao statuspublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao validatepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao verdict-gatepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao verify initpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao verify receiptspublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao verify statspublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao versionpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao yield emitpublic-stateful-fixture-neededallowlistedParent of accept/gate-verdict/usage; writes the yield ledger and needs a bead+run fixture. Pre-existing gap surfaced by an unrelated cli/cmd/ao change (ag-62jrm).
ao yield gaugepublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao yield reportpublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.
ao yield tokenspublic-testedcoveredCovered by release smoke tests, direct command tests, or command handler tests.