Skip to content

CLI commands

Checked against the .command( registrations in src/cli.ts on the 0.11.0-rc.1 tree: 83 commands and subcommands, against 35 in 0.9.0. Commands marked 0.11 are new since 0.9.0; they ship in 0.11.0-rc.1 on the npm next tag, not in 0.9.0 on latest. Run uh <command> --help for every flag.

Command Purpose
uh init Create a .harness/ project
uh validate [file] Validate a YAML artifact. --repair / --json add drift detection, --strict-spec makes spec-stale issues errors, --judge --spec grades spec adherence with a model
uh status Project state; --json needs no model
uh verify <mission-id> Run required checks, then the optional model judge; writes verification.yaml
uh promote <mission-id> Record a human promotion decision (--approved-by)
uh propose [id] Generate a mission packet from issue metadata or a .spec.md
uh tui Interactive Mission Control (spawns Bun); uh tui screenshot --view <view>
uh ps Live runs; exit 3 when any run is orphaned 0.11
uh kill [run-id] Stop runs by id or prefix, --mission, --role, --team, --all or --orphans, and prove they are gone 0.11
uh wait [run-id] Block until runs settle (--mission, --team, --timeout-ms; exit 0, 1, 3, 4; 2 when nothing matches) 0.11
uh resume <run-id> Resume a settled run’s native session as a new run 0.11
uh steer <run-id> <message> Stop the attempt and resume it with a new first instruction 0.11
uh report <run-id> Disk-only report of what a run did, no model call 0.11
uh land Gated cherry-pick of verified, reviewed worker branches (--worker-branch, --onto, --message-file). Refuses unless the target worktree has --onto checked out; removes the landed workers’ worktrees unless --keep-worktrees 0.11
uh note <text> Record an intervention on the ledger 0.11
Subcommand Purpose
create <id>, new <id> Scaffold a packet (new adds design.md)
show <mission-id> Print a mission
verdict <mission-id> <value> Record a manual verdict
dry-run [file] Route and render without launching; --strict
run [file] Supervised run; --runtime, --auto, --template, --post-checks, --quiet, --no-sandbox, --force, --strict
cancel Cancel a run through its controller
run-all <mission-id> One mission on several runtimes; --strict
run-team <mission-id> Worker waves in worktrees, mechanical integration, verify; --replace refuses while any run is live, stale or unknown
check <file> Validate a packet without launching 0.11
put <files...> Validate and install packets atomically 0.11
review-prepare <id>, review-collect <id> Independent review round trip 0.11
prune-runs <mission-id> --keep <n> Archive a mission’s oldest runs beyond a cap and remove their run directories 0.11

--strict turns capability mismatches into errors; without it each mismatch is a [WARN] line and the run proceeds (UH-138). runtime_requirements always block.

Group Subcommands
uh adapter list, check [runtime], add <runtime>, capabilities, cost-forecast
uh sandbox create <id>, list, status <id>, discard <id>; repair (0.11)
uh skill add <dir>, list, check <id>
uh spec scaffold (tests from acceptance criteria), template [name]
uh observatory snapshot; runs, compare, export <mission-id> --otlp (0.11)
uh queue run <file> (--max-orchestrators, default 2), status <queue-id>. Entries route like uh mission run; only sandbox: false runs in the project root 0.11
uh hive import <file>, show, verify (--repair re-links a chain forked by the old concurrent-append bug and refuses any other break) 0.11
uh ledger list, summary, land <id>, confirm <id>, import <file> 0.11
uh notify detect, list, test 0.11
uh acceptance run [capability], status, rebind, report 0.11
uh experiment plan <id>, run <id>, report <id> 0.11
uh mcp serve 0.11
Code Meaning
0 passed
1 failed
2 blocked (refused before spawn, or nothing matched for wait)
3 an orphaned run exists (ps, wait)
4 wait timed out
130 cancelled
143 terminated by signal
Variable Used for
OPENROUTER_API_KEY openrouter adapter
ANTHROPIC_API_KEY anthropic adapter
TYPESAFE_API_KEY, UH_TYPESAFE_MODEL System One verification judge, semantic routing, and the loop watchdog when a mission opts in
HONCHO_* optional Honcho memory
UH_TELEMETRY=posthog, UH_POSTHOG_API_KEY opt-in product telemetry
UH_NOTIFICATIONS_FILE user notification config path
UH_NOTIFICATIONS_TRUST_PROJECT=1 allow sinks in the project file that start a command or read an environment variable into a header
UH_CLI_BIN the uh binary the Hermes plugin calls
UH_TOOL_GUARD_POLICY, UH_TOOL_GUARD_LOG set by UH for guard hooks; not for manual use

Several of these are missing from .env.example (see the debt register).