CLI reference

heddle status

Shipped

heddle status [OPTIONS]

Show what needs attention and the next safe Heddle action

Output text (default) · json · json-compact

Flags

--short <SHORT>, -s <SHORT>: Short format values: true · false
--watch <WATCH>: Continuously refresh status values: true · false
--watch-iterations <WATCH_ITERATIONS> hidden: Internal helper for tests: stop after N watch updates Accepted by the CLI, but absent from standard --help.
--watch-interval-ms <WATCH_INTERVAL_MS> hidden: Internal helper for tests: polling interval in milliseconds Accepted by the CLI, but absent from standard --help.

Exit codes

Declared by this command's contract, verbatim. Anything not listed contracts only to 0 on success and an unspecified non-zero on failure. The full table and the retry rule — in short, 75 is the only code that is safe to retry.

0: ok
74: io reading workspace state

Examples

current thread, dirty paths, recommended next step

bash$ heddle status

one-line summary for shell prompts

bash$ heddle status --short

live dashboard that refreshes in place

bash$ heddle status --watch