Claude Code Session Recovery
Description
Diagnose and repair Claude Desktop session metadata bugs on Windows and Mac — missing conversation history, lost transcripts, duplicate sessions, junction-induced splits, lost groupings.
Installation
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open the source below and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
README
Claude Code Desktop Session Recovery & Repair Tools
[](https://www.python.org/downloads/) [](LICENSE)
Supports Windows and macOS. Windows MSIX (Microsoft Store) install: `diagnose.py` works; write-bearing repair scripts do not — see [MSIX note](#msix-microsoft-store-installs) below.
Something broke somewhere with your sessions in Claude Desktop. Because I'm a bit special I've broken my Desktop sessions in lots of different ways. I made this to help you diagnose and hopefully fix it if something has gone wrong for you too.
Releases
Every change to this public repository is versioned. `VERSION`, the matching annotated `vX.Y.Z` tag, and the exact tagged commit are checked by [the release process](docs/release-process.md).
Fix it with Claude Code (or any AI)
This runs best from a **Claude Code CLI session** (or Codex/ChatGPT), not from Claude Desktop because the Desktop app needs to be closed to apply the fixes. If you run it from Desktop, the tool will detect it, warn you and give you instructions if you're still more comfortable running from Claude Desktop.
**Step 1 — open a CLI session**
Open a terminal (Windows Terminal, PowerShell, cmd, or macOS Terminal), then run:
claudeThat starts Claude Code in your terminal.
**Step 2 — paste this prompt**
My Claude Code sessions are broken on Windows or macOS. Please help me fix them using https://github.com/BasedGPT/claude-code-session-recovery
1. Clone the repo and cd into it: `git clone https://github.com/BasedGPT/claude-code-session-recovery` then `cd claude-code-session-recovery`
2. Read AGENTS.md — it's written for AI assistants and explains how to use this repo safely
3. Read docs/session-recovery.md to understand the symptoms and repair tools
4. Run `python tools/diagnose.py` — it auto-detects all file paths from the environment, no configuration Related Skills
Auto Update
Pull the latest ECC repo changes and reinstall the current managed targets.
Ecc Guide
Navigate ECC's current agents, skills, commands, hooks, install profiles, and docs from the live repository su
Epic Claim
Claim an epic issue, stamp coordination state, and sync local ownership.
Epic Publish
Publish a validated epic update back to the issue and local cache.
Epic Review
Mark epic review requested, approved, or changes requested.
Epic Unblock
Sweep blocked epic issues and reopen anything whose dependencies are closed.