Ce que fait cet outil

claude-file-recovery est un outil en ligne de commande Python avec une interface utilisateur textuelle interactive qui extrait les fichiers de l'historique des sessions de Claude Code. Il a été créé après que l'auteur ait accidentellement supprimé des fichiers via un lien symbolique que Claude Code n'a pas reconnu, et que sa sauvegarde n'ait pas fonctionné pendant un mois. L'outil reconstruit les fichiers en analysant les transcriptions de session JSONL stockées dans ~/.claude/projects/.

Fonctionnalités principales

L'outil peut récupérer tout fichier que Claude Code a jamais lu, modifié ou écrit, y compris les versions antérieures des fichiers à des instants précis. Il propose :

• Interface TUI interactive avec recherche floue et raccourcis clavier vim (j/k/g/G, / pour rechercher)
• Récupération à un instant précis — reconstruire les fichiers à n'importe quel instant historique, pas seulement la dernière version
• Affichage des différences coloré montrant comment les fichiers ont changé au fil du temps (modes unifié, contexte complet et brut)
• Extraction par lots — sélectionner plusieurs fichiers et les extraire tous en une fois
• Analyse rapide — analyse parallèle des sessions avec orjson et vérifications d'octets rapides qui ignorent ~77 % des lignes avant l'analyse
• Déduplication des liens symboliques — détecte les chemins aliasés et les fusionne en entrées canoniques
• Recherche intelligente — sensible à la casse uniquement lorsque votre requête contient des majuscules (comme ripgrep)

Installation et utilisation

Nécessite Python 3.10+. Options d'installation :

# Recommandé
uv tool install claude-file-recovery

Ou avec pipx
pipx install claude-file-recovery
Ou avec pip
pip install claude-file-recovery

Commandes de base :

# Lancer l'interface TUI interactive (commande par défaut)
claude-file-recovery

Lister tous les fichiers récupérables
claude-file-recovery list-files
Filtrer par motif
claude-file-recovery list-files --filter '*.py'
Exporter en CSV
claude-file-recovery list-files --filter '*.ts' --csv
Extraire les fichiers sur le disque
claude-file-recovery extract-files --output ./recovered --filter '*.py'
Récupérer les fichiers tels qu'ils étaient avant un certain moment
claude-file-recovery list-files --before '2025-02-20 14:00'
Pointer vers un répertoire de données Claude différent
claude-file-recovery --claude-dir /path/to/claude-backup

Comment cela fonctionne

L'outil analyse tous les fichiers de session JSONL sous ~/.claude/projects/ et les analyse en parallèle à l'aide d'un pool de threads. Il corrèle les requêtes d'utilisation d'outil dans les messages de l'assistant à leurs résultats dans les messages de l'utilisateur via tool_use_id, puis reconstruit les fichiers en rejouant les opérations dans l'ordre chronologique par chemin de fichier : les opérations d'écriture définissent le contenu, les opérations d'édition appliquent des remplacements de chaînes, et les opérations de lecture capturent des instantanés. L'option --before utilise une recherche binaire pour couper à n'importe quel instant.

Raccourcis clavier de l'interface TUI

• j/k : Monter/descendre
• g/G : Aller en haut/bas
• / : Rechercher
• Ctrl+R : Changer de mode de recherche (flou / glob / regex)
• x ou Espace : Basculer la sélection de fichier
• Entrée : Voir les détails du fichier + différences
• d : Changer de mode de différence (unifié / contexte complet / brut)
• Ctrl+E : Extraire les fichiers sélectionnés
• q : Retour / quitter

Ce type d'outil de récupération est utile pour les développeurs qui utilisent intensivement Claude Code et veulent une assurance contre la suppression ou la corruption accidentelle de fichiers. Le projet sous licence MIT a 26 étoiles et 1 fork sur GitHub au moment de la rédaction.