Failure Modes — Triage Outline

Triage outline

Source: Failure-mode notes and rc.199 local checks. Scope reviewed 2026-09-22.

Short triage outline, not the full internal runbook or a guarantee of recovery time.

This is a summary, not the full source document. It is not automatically synchronized with the source.

For current setup and support, read Quickstart and Troubleshooting.

  1. Start with Settings → Build info and note the version. Check the Dashboard sidecar status before investigating a missing graph or Recall result.
  2. If Recall reports that its index is preparing, allow preparation to finish and retry. A successful retry does not by itself prove every background task is healthy.
  3. For unresolved problems, contact support@klawforge.com with the version and a description of the symptom. Review logs for private content before sharing them. On macOS, the sidecar log is ~/Library/Logs/app.klawforge.desktop/sidecar.log.

What to check

  • App will not open: consult Installation and Troubleshooting for the current platform requirements.
  • Sidecar is unavailable: record the Dashboard status and inspect the sidecar log for the startup error.
  • Recall is unavailable: distinguish index preparation from other errors; retain the error text when asking for help.
  • Gardener work is waiting: a quota limit can leave work queued. Pending work and retry-exhausted failures are different states.
  • Graph counts differ: check the selected project and visible-node limit before assuming memory was lost.