Doctor And Troubleshooting

How to verify setup and repair common beta issues.

Start with doctor:

kairn doctor
kairn doctor --fix

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;
MCP config missing: rerun setup wizard for your client.

Telemetry And Privacy

What private beta telemetry collects and what it never uploads.

Uninstall

How to remove Kairn-owned local state and package installs.