CLI reference#

The command-line reference lives in its own section: CLI reference.

It is the single authority for the hmp surface. Keeping the inventory in one place is deliberate: two competing lists drift apart, and a stale verb table is worse than no table.

Page

What it covers

CLI reference

Every family, every sub-action, and the run-reference grammar.

hmp run, calibrate, spinup

hmp run, hmp calibrate, hmp spinup and the workflow flags (--dry-run, --resume, --overlay, --set, …).

hmp catalog

Browsing, annotating, trashing, exporting and reindexing runs.

hmp project and hmp workspace

Project and workspace lifecycle, plus the machine-wide index.

hmp viz

Figure discovery and rendering.

hmp dev

Developer-only verbs: schema, lockfile, prototype runner.

hmp audit and hmp privacy

Audit log and certified purge.

Exit codes

Typed exit codes for scripts and CI gates.

Shell completion

Shell completion for bash, zsh and fish.

For the first-run path, see CLI quickstart. For reading and exporting results, see Results and exports. For the catchment_report.toml contract behind hmp report catchment, see Catchment HTML Reports.