Was dieses Tool macht

claude-file-recovery ist ein Python-Kommandozeilenwerkzeug mit einer interaktiven TUI, das Dateien aus der Sitzungshistorie von Claude Code extrahiert. Es wurde erstellt, nachdem der Autor versehentlich Dateien über einen Symlink gelöscht hatte, den Claude Code nicht erkannte, und sein Backup einen Monat lang nicht gelaufen war. Das Tool rekonstruiert Dateien, indem es JSONL-Sitzungstranskripte analysiert, die in ~/.claude/projects/ gespeichert sind.

Wichtige Funktionen und Funktionalität

Das Tool kann jede Datei wiederherstellen, die Claude Code jemals gelesen, bearbeitet oder geschrieben hat, einschließlich früherer Versionen von Dateien zu bestimmten Zeitpunkten. Es bietet:

• Interaktive TUI mit Fuzzy-Suche und Vim-Tastenkürzeln (j/k/g/G, / zum Suchen)
• Punktgenaue Wiederherstellung – Dateien zu jedem historischen Zeitpunkt rekonstruieren, nicht nur die neuesten
• Farbige Diff-Ansicht, die zeigt, wie sich Dateien im Laufe der Zeit verändert haben (unified, full-context und raw-Modi)
• Stapelverarbeitung – mehrere Dateien auswählen und alle auf einmal extrahieren
• Schnelles Scannen – parallele Sitzungsanalyse mit orjson und Fast-Reject-Byte-Prüfungen, die ~77 % der Zeilen vor der Analyse überspringen
• Symlink-Deduplizierung – erkennt Alias-Pfade und fasst sie zu kanonischen Einträgen zusammen
• Smart-Case-Suche – nur bei Großbuchstaben in der Abfrage case-sensitive (wie bei ripgrep)

Installation und Verwendung

Erfordert Python 3.10+. Installationsoptionen:

# Empfohlen
uv tool install claude-file-recovery

Oder mit pipx
pipx install claude-file-recovery
Oder mit pip
pip install claude-file-recovery

Grundlegende Befehle:

# Interaktive TUI starten (Standardbefehl)
claude-file-recovery

Alle wiederherstellbaren Dateien auflisten
claude-file-recovery list-files
Nach Muster filtern
claude-file-recovery list-files --filter '*.py'
Als CSV exportieren
claude-file-recovery list-files --filter '*.ts' --csv
Dateien auf die Festplatte extrahieren
claude-file-recovery extract-files --output ./recovered --filter '*.py'
Dateien so wiederherstellen, wie sie vor einem bestimmten Zeitpunkt waren
claude-file-recovery list-files --before '2025-02-20 14:00'
Auf ein anderes Claude-Datenverzeichnis verweisen
claude-file-recovery --claude-dir /path/to/claude-backup

Wie es funktioniert

Das Tool scannt alle JSONL-Sitzungsdateien unter ~/.claude/projects/ und analysiert sie parallel mit einem Thread-Pool. Es korreliert Tool-Use-Anfragen in Assistant-Nachrichten mit ihren Ergebnissen in User-Nachrichten über tool_use_id und rekonstruiert dann Dateien, indem es Operationen chronologisch pro Dateipfad wiedergibt: Write-Operationen setzen Inhalte, Edit-Operationen wenden String-Ersetzungen an und Read-Operationen erfassen Snapshots. Das Flag --before verwendet eine binäre Suche, um an jedem Zeitpunkt abzuschneiden.

TUI-Tastenkürzel

• j/k: Nach oben/unten bewegen
• g/G: Zum Anfang/Ende springen
• /: Suchen
• Ctrl+R: Suchmodus durchschalten (fuzzy / glob / regex)
• x oder Space: Dateiauswahl umschalten
• Enter: Dateidetails + Diffs anzeigen
• d: Diff-Modus durchschalten (unified / full-context / raw)
• Ctrl+E: Ausgewählte Dateien extrahieren
• q: Zurück / beenden

Diese Art von Wiederherstellungstool ist nützlich für Entwickler, die Claude Code intensiv nutzen und sich gegen versehentliches Löschen oder Beschädigung von Dateien absichern möchten. Das MIT-lizenzierte Projekt hat zum Zeitpunkt dieses Schreibens 26 Sterne und 1 Fork auf GitHub.