Doctor And Troubleshooting

Start with doctor:

kairn doctor
kairn doctor --fix

The kairn enable troubleshooting steps below require the published v0.2 beta. If kairn --version is older than 0.2.0-beta.2, run npm install -g usekairn@beta first.

Target a specific integration when you do not use every mode:

kairn doctor --target vscode
kairn doctor --target codex

Common warnings:

• empty or stale index: run kairn index refresh;
• missing Codex command: install Codex CLI or use MCP;
• hook needs review: open /hooks in Codex;
• integration config missing: run kairn enable --dry-run, inspect the proposed change, then run kairn enable;
• stale savings mode: run kairn doctor --fix to migrate to the canonical source-first setup mode.