desktop

Recover Desktop safely

Restore provider, runtime, database, workspace, or session health without erasing useful history.

Desktopintermediate0.7.0 Stable
Verified 2026-07-13View sourceReport a docs issue

Start with the first visible problem rather than deleting application data. Keep the affected session and diagnostics until you know which part failed.

Kestrel Desktop diagnostics showing runtime health and operator recovery controls
Diagnostics separates provider, Local Core, database, workspace, and session state so recovery can target the actual failure.

Find the unhealthy component

  1. Read the status shown in Desktop and note the affected session.
  2. Check provider access, Local Core, managed database, workspace access, and session persistence in that order.
  3. Restart only the component identified as unhealthy.
  4. Reopen the original workspace and session.
  5. Confirm that the transcript and last terminal state are still present before retrying.