Troubleshooting
Fixes for the most common context-mode setup and runtime issues.
Most problems trace back to one of three causes. Find the matching symptom below — each item tells you how to confirm the cause and what to run to fix it.
| Symptom | Likely cause | Fix |
|---|---|---|
| Continuity drops after compaction | Hooks not all registered | Re-run host setup |
ctx_* tools look empty or duplicated | Stale MCP entry from an earlier install | context-mode upgrade |
| FTS5 / SQLite errors at startup | Runtime older than Node.js 22.5 | Upgrade Node or use Bun |