Claude Code Session Recovery
0Rebuilds 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
Want this level of depth on your own project?
The classes teach the same production techniques these repos are built with — scar tissue included.