hjtenklooster

hjtenklooster / claude-file-recovery

Public

Recover files created and modified by Claude Code from JSONL session transcripts

pypi.orgprojectclaude-file-recovery claude claude-code cli developer-tools file-recovery
92
1
100% credibility
Found Feb 28, 2026 at 79 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

Tool that reconstructs files created or modified by Claude Code AI from its session transcripts stored in the user's Claude directory.

How It Works

1
😩 Lost files from AI sessions

You notice files created during your AI coding helper chats have vanished or scattered across sessions.

2
📥 Grab the recovery tool

You quickly download and set up the simple recovery helper designed just for this.

3
🔍 It finds everything

Launch it and watch as it scans your chat logs to rediscover all the files the AI touched.

4
👀 Browse your files

Jump into the easy viewer to search, preview changes over time, and see diffs of what happened.

5
✅ Pick what to save

Select the files or versions you want, handling any shortcuts or extras along the way.

6
💾 Recover them instantly

With one go, pull the files back to a new folder on your computer, clean and ready.

🎉 Files back, work resumes

Your project files are restored perfectly, so you pick up right where the AI left off.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 79 to 92 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-file-recovery?

This Python CLI and TUI tool recovers files created or edited by Claude Code from JSONL session transcripts in ~/.claude/projects/, replaying Write, Edit, and Read operations chronologically to reconstruct exact states—even lost ones across sessions. Launch the interactive TUI for fuzzy search, vim keybindings, and colored diffs, or use commands like `claude-file-recovery list-files --filter '*.py'` and `extract-files --output ./recovered` for quick recovery. It's a free GitHub recover repository tailored for Claude users needing to salvage code from AI sessions.

Why is it gaining traction?

Its TUI shines with point-in-time recovery, batch extraction, and symlink deduplication for git worktrees, plus auto-stripping of Claude's injected content from Read ops. Parallel scanning skips 77% of log noise for speed, and smart-case fuzzy/glob/regex search feels native. Developers hook on the demo data and vim-like navigation, turning messy session logs into browsable, extractable file histories.

Who should use this?

Claude Code users prototyping apps or generating boilerplate who lose local files mid-session. Backend devs recovering Python/Flask configs or SQL migrations from transcripts, frontend folks pulling React/TSX components. Linux users with symlinked projects (worktrees, mounts) facing duplicate paths in logs.

Verdict

Worth installing via uv tool for Claude Code workflows—polished TUI and CLI make file recovery painless despite alpha status. With 23 stars and 1.0% credibility, test on backups first; docs and demo data boost confidence.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.