hermit-doctor

Solid

Returns a twenty-four-check health report on the hermit installation (runtime, config, hooks, state-file integrity, cost, proposals, deps, version currency, permissions, docker, archival, reflect loop, scheduler, watchdog, context age, opus-wake spend, routine cost, heartbeat, routine monitor, raw storage size, sibling-plugin credential expiry, model pricing, channel liveness, context scan). Use when diagnosing an install, before a release, or after suspicious behavior. Activates on messages like "/hermit-doctor", "health check", "diagnose the hermit", "what's wrong", "run diagnostic".

AI & Automation 68 stars 11 forks Updated today MIT

Install

View on GitHub

Quality Score: 79/100

Stars 20%
61
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Hermit Doctor Runs twenty-four read-only health checks against the current hermit install (`channel-liveness` is the only one that performs outbound API calls — see Notes) and surfaces the summary. Safe to run at any time. Produces no side effects beyond writing `.claude-code-hermit/state/doctor-report.json` and appending a summary block to SHELL.md. ## Steps 1. Run the check script: ```bash bun ${CLAUDE_PLUGIN_ROOT}/scripts/doctor-check.ts .claude-code-hermit ``` The script writes `.claude-code-hermit/state/doctor-report.json` and prints the same JSON to stdout. It exits 0 unconditionally — on any internal failure the failing check reports `status: "fail"` in its own entry rather than crashing the report. 2. Parse the JSON. For each of the twenty-four checks in the report (`runtime`, `config`, `hooks`, `state`, `cost`, `proposals`, `dependencies`, `version-currency`, `permissions`, `docker-security`, `archive`, `reflect`, `scheduler`, `watchdog`, `context-age`, `opus-wake`, `routine-cost`, `heartbeat`, `routine-monitor`, `raw-size`, `credential-expiry`, `model-pricing-known`, `context-scan`, `channel-liveness`), emit one line using this format: - `✓ <id> — <detail>` when `status: ok` - `⚠ <id> — <detail>` when `status: warn` - `✗ <id> — <detail>` when `status: fail` 3. Append a summary section to `.claude-code-hermit/sessions/SHELL.md` under a new `## Doctor Report (<ts>)` heading. Use the same twenty-four lines from step 2. Place i...

Details

Author
gtapps
Repository
gtapps/claude-code-hermit
Created
4 months ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category