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).