Alex CoulombePresents
← all repos

Claude Code Session Recovery

0

Rebuilds Claude Desktop's session index after a crash — your conversations were never actually gone.

The story

Claude Code stores every session as a JSONL file on disk, but Claude Desktop keeps a separate index of what to show in its sidebar — and that index is exactly the thing that corrupts after a BSOD, hard shutdown, or disk error, making sessions vanish from the UI while the underlying data sits untouched. This tool just rebuilds the index: list every session on disk with a ready-to-run `claude --resume` command, dry-run a restore to see what's actually missing, then restore it for real. Pure Python stdlib, no dependencies, works the same on Windows, macOS, and Linux.

Highlights

  • Fixes the actual bug: Desktop's session INDEX corrupts, not the session data itself
  • `list` — every on-disk session with a ready-to-run claude --resume command
  • `restore --dry-run` — see exactly what's missing before touching anything
  • `export` — plain-text transcripts for full-text search or archival
  • Python 3.8+, stdlib only, zero external dependencies
$ git clone https://github.com/ibrews/claude-session-recovery.git