Troubleshooting Keprix¶

Use this guide when something in the web UI, CLI, or agent loop does not behave as expected. Each section lists Symptom → Likely cause → Fix → Related routes/docs.

For product feature detail, start from the full product map or the in-app Docs catalog at /docs.

How to escalate¶

1. Note the exact URL, what you clicked, and any error text or correlation ID shown in the UI or logs.
2. Check known issues for the running version (keprix --version or Settings).
3. Re-run health: curl -s http://127.0.0.1:3333/api/health (or your public /api/health).
4. If chat answers about Keprix itself are wrong, re-index self-knowledge (see Self-knowledge).

Quick links¶