Self-Diagnosis & Health Check
Run a cascading diagnostic checklist to verify interkasten is correctly installed and operating.
Use when: user says "check interkasten", "interkasten health", "is interkasten working", "diagnose interkasten", or invokes /interkasten:interkasten-doctor.
Run checks in order. If an early check fails, skip dependent checks and show remediation.
Check if ~/.interkasten/config.yaml exists by calling interkasten_config_get.
interkasten_init to create it, or create ~/.interkasten/config.yaml manually."If this check fails, skip to the summary — without config, nothing else works.
Check if INTERKASTEN_NOTION_TOKEN environment variable is set. You can infer this from the interkasten_health response or interkasten_init behavior.
Call interkasten_health to get the full status. If the call succeeds, the MCP server is running (Check 3 passes implicitly).
ntn_)INTERKASTEN_NOTION_TOKEN=<token> to ~/.interkasten/.env and running chmod 600 ~/.interkasten/.envclaude plugins list) and the server process is running."If MCP is unreachable, mark checks 4-7 as "skipped (MCP unavailable)".
Parsed from the interkasten_health response (already called in Check 2):
From the health response:
sqlite.connected is trueFrom the health response:
Call interkasten_list_projects:
/interkasten:layout to discover and register projects."From the health response:
wal.pending_entries = 0 — "Clean (no pending operations)"wal.pending_entries > 0 — "N pending sync operations. Run interkasten_sync to flush."Report whether hooks are defined in hooks/hooks.json. This is informational — empty hooks is not an error.
Present results as a formatted checklist:
interkasten doctor
Config file ~/.interkasten/config.yaml found
Notion token Set (INTERKASTEN_NOTION_TOKEN)
MCP server Running (v0.3.12, PID 12345, uptime 4h, 45MB)
SQLite Connected
Notion connection Healthy (circuit closed, last success 5m ago)
Projects 18 registered (12 Product, 4 Tool, 2 Inactive)
WAL Clean (0 pending)
Hooks 2 hooks defined (SessionStart, Stop)
8/8 checks passed.
Use these status indicators:
(checkmark) for pass (warning) for warn (cross) for fail-- for skippedIf any checks failed, end with remediation summary:
5/8 checks passed. 1 failed. 2 skipped.
To fix:
1. Set INTERKASTEN_NOTION_TOKEN (see above for instructions)
2. Skipped checks will pass once the Notion token is configured
interkasten_health tool is not available at all (not in tool list), the MCP server plugin is not installed. Tell the user: "interkasten MCP server not found. Install the plugin: claude plugins install https://github.com/mistakeknot/interkasten"