hiiu doctor

hiiu doctor

Checks the machine and reports what it found. This is the first command to run after installing, and the first thing to run when something else behaves strangely.

Arguments and flags #

None of its own, and no path: it describes the machine rather than an app. Every global flag applies.

What it checks #

Check	Status if missing
node	fail below the supported major
git	fail
package-manager	fail
playwright	warn
config-dir	fail if not writable
cache-dir	fail if not writable

Playwright is a warning on purpose. Only verify needs a browser, and a machine that reads repositories all day is healthy without one. Making it a failure would tell people to spend a per-platform browser download before running analyze.

It reports and still fails #

Under --json this is the clearest example of the two-shapes rule: on an unhealthy machine it emits its own document, with ok: false and the failing checks named, and exits 3. It does not emit an error envelope.

So do not infer the shape from the exit code. Branch on ok, then read checks.

Exit codes #

Code	When
0	Healthy, warnings included
3	At least one check failed

Example #

hiiu doctor --json | jq '.checks[] | select(.status != "ok")'