Gaia CLI
Status: Reference layer for the
gaiacommand-line app.
The installed entrypoint is gaia. The current v0.5 command surface is
organized into explicit top-level groups:
| Group | Members | Purpose |
|---|---|---|
| author | 18 statement-emitting verbs + 2 composition registration verbs (note / claim / derive / variable / ... / compose) |
Agent-first authoring surface — append DSL statements through the cli without hand-editing source |
| build | init / compile / check |
Create and validate a knowledge package |
| run | infer / render |
Execute inference and emit presentation outputs |
| inspect | starmap |
Visualize the compiled package graph |
| review | (skeleton — no commands in alpha 0) | Reserved for downstream reviewer tooling |
| inquiry | focus / review / obligation [add\|list\|close] / hypothesis [add\|list\|remove] / tactics log / reject |
Local semantic-inquiry loop (unchanged) |
| pkg | add / add-import / add-module / register / scaffold |
Install dependencies, manage package modules/imports, publish, and bootstrap packages |
| search | lkm [knowledge\|reasoning\|nodes\|package\|auth] |
Retrieve remote knowledge candidates for Gaia authoring; future home for local package search |
| bayes | model / compare / distribution literals |
Bayesian model and distribution authoring helpers |
| trace | verify / review / show |
ARM Trace tooling (independent sub-app; unchanged) |
The pre-alpha-0 leaf verbs keep their original internal logic, semantics,
and option flags under grouped paths. The author, bayes, pkg scaffold,
pkg add-import, and pkg add-module surfaces are v0.5 cli-as-client
additions rather than old flat-verb redirects.
Migrating from earlier versions
Alpha 0 removed the 9 historical flat verbs (gaia compile, gaia infer,
gaia starmap, etc.); invoking them now fails with typer's standard
No such command usage error and exits with code 2. See
Migration to alpha 0 for the full old-to-new
mapping and the related Python import-path changes.
Internals
For Typer wiring and command implementation entry points, see CLI Internals.
For end-user CLI invocation reference (option flags, examples, workflow), see CLI Commands.