🔮

Recover Files Deleted by Claude

Your AI made a mistake. Here's how to fix it.

😱 The Problem

You asked Claude to clean up, refactor, or delete files. Claude's File History saved snapshots of everything—but now they're gone from your disk and you need them back.

✨ The Solution

Claude Time Machine searches through ~/.claude/file-history and recovers your deleted files. Search by name, content, or time range. View diffs. Compare versions. Recover exactly what you need.

⚡ One-Click Install

Copy and paste this into your terminal:

curl -fsSL https://gist.githubusercontent.com/laurentcharignon/recover-files-claude/raw/main/recover_claude_files.py | python3 -

🔍

Search

Find files by name, content, or regex

⏰

Filter by Time

Narrow results by modification time

📊

View Timeline

See all versions of a file

📝

Compare Diffs

See exactly what changed

💾

Recover

Export any version to disk

⚡

Fast

Runs instantly on your machine

📖 Quick Examples

Search for a file by name:

python recover_claude_files.py --search justfile

Search by content within a time window:

python recover_claude_files.py --search "@pdf" --time-range 02:00 04:00

List all indexed files:

python recover_claude_files.py --list

View timeline for a specific file:

python recover_claude_files.py --timeline {file_id}

Compare two versions:

python recover_claude_files.py --diff {file_id} v1 v7

Recover a specific version:

python recover_claude_files.py --recover {file_id} --version v7 --output ~/recovered/

✓ Copied to clipboard!