human doctor
Environment and authentication health check
Diagnoses your HUMΛN CLI environment. Checks Node.js version, config file, delegation token liveness, database, API keys, and API connectivity.
Flags
| Flag | Description |
|---|---|
--json | Output check results as a JSON array (CI-friendly) |
--fix | Auto-remediate fixable issues (e.g. create missing ~/.human/config.yaml) |
Checks
| Check | What it verifies |
|---|---|
| Config file | ~/.human/config.yaml exists |
| Node.js Version | Node 20+ recommended |
| Authentication | Profile has a passportId |
| Delegation token | Token accepted by GET /v1/passports?limit=1 |
| Database | DATABASE_URL is set and connectable |
| API Keys | OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_API_KEY |
| ModelRegistry | model_profiles table exists |
| API Connectivity | GET /health reachable |
Examples
human doctor
human doctor --json | jq '[.[] | select(.status == "fail")]'
human doctor --fixCI usage
- run: human doctor --jsonExit code 0 = all checks pass or warn. Exit code 1 = at least one fail.