claude-conversation-cleanup: Recover Broken Claude Conversations


Claude Code conversations sometimes error out in ways that make them impossible to resume. An image attachment that’s too large, the context window filling up before compaction kicks in, a tool call that tried to access something outside the sandbox — these leave the conversation in a broken state. You can’t continue it, but all the context you’ve built up is still in there.

This tool lets you fix that. It reads Claude’s local conversation files (~/.claude/projects/), lets you inspect each message, and delete the ones causing the error. Remove the oversized image or the offending tool call, and the conversation becomes resumable again.

claude-conversation-cleanup screenshot

It also generates smart titles for each conversation, which makes it much easier to find and recall past sessions compared to scanning raw JSONL filenames.

Backups are created automatically before any deletion, so you can always undo. Everything stays local — no cloud, no API calls.

See the GitHub repo for setup and usage.