Project Diagnostics

umbra doctor runs a full health check and prints a structured report of what is working, what needs attention, and what is broken.

umbra doctor           # print the report
umbra doctor --fix     # apply auto-fixable issues (e.g. create missing directories)
umbra doctor --json    # machine-readable JSON output

Checks performed

Check	What it verifies
Workspace filesystem	Current directory is readable and writable
Umbra memory root	~/.umbra exists and is accessible
better-sqlite3 native	The native addon loads under the current Node binary
Daemon port	127.0.0.1:8080 is available (or the daemon already holds it)
PM2 process	umbra-daemon is registered and its PM2 status
Daemon health	The HTTP gateway responds with { ok: true }
SQLite readiness	Database opens, sqlite-vec loads, embeddings model status
Web search provider	Configured provider has the required API key

Each item reports one of four statuses: pass, warn, fail, or fixed (applied by --fix). The overall exit code is non-zero if any item is fail.