このツールの機能

claude-file-recoveryは、Claude Codeのセッション履歴からファイルを抽出するPythonコマンドラインツールで、インタラクティブなTUIを備えています。このツールは、作者がClaude Codeが認識しないシンボリックリンク経由で誤ってファイルを削除し、バックアップが1ヶ月間実行されていなかったことをきっかけに作成されました。ツールは~/.claude/projects/に保存されたJSONLセッショントランスクリプトを解析することでファイルを再構築します。

主な機能

このツールは、Claude Codeが読み取り、編集、または書き込みを行ったすべてのファイルを復元でき、特定時点でのファイルの以前のバージョンも復元できます。提供される機能は以下の通りです：

• ファジー検索とVimキーバインド（j/k/g/G、/で検索）を備えたインタラクティブTUI
• ポイントインタイムリカバリ — 最新だけでなく、任意の履歴スナップショットでファイルを再構築
• 時間経過によるファイルの変更を示すカラー差分表示（ユニファイド、フルコンテキスト、および生データモード）
• バッチ抽出 — 複数のファイルを選択して一度にすべて抽出
• 高速スキャン — orjsonと高速拒否バイトチェックによる並列セッションパーシングで、解析前に約77%の行をスキップ
• シンボリックリンクの重複排除 — エイリアスされたパスを検出し、正規エントリに統合
• スマートケース検索 — クエリに大文字が含まれる場合のみ大文字小文字を区別（ripgrepと同様）

インストールと使用方法

Python 3.10以上が必要です。インストールオプション：

# 推奨
uv tool install claude-file-recovery

またはpipxで
pipx install claude-file-recovery
またはpipで
pip install claude-file-recovery

基本的なコマンド：

# インタラクティブTUIを起動（デフォルトコマンド）
claude-file-recovery

復元可能なすべてのファイルをリスト表示
claude-file-recovery list-files
パターンでフィルタリング
claude-file-recovery list-files --filter '*.py'
CSVとしてエクスポート
claude-file-recovery list-files --filter '*.ts' --csv
ファイルをディスクに抽出
claude-file-recovery extract-files --output ./recovered --filter '*.py'
特定の時間以前の状態でファイルを復元
claude-file-recovery list-files --before '2025-02-20 14:00'
別のClaudeデータディレクトリを指定
claude-file-recovery --claude-dir /path/to/claude-backup

仕組み

このツールは~/.claude/projects/以下のすべてのJSONLセッションファイルをスキャンし、スレッドプールを使用して並列に解析します。tool_use_idを介してアシスタントメッセージ内のツール使用リクエストとユーザーメッセージ内の結果を関連付け、ファイルパスごとに時系列順に操作を再生することでファイルを再構築します：書き込み操作は内容を設定し、編集操作は文字列置換を適用し、読み取り操作はスナップショットをキャプチャします。--beforeフラグは、任意の時点で打ち切るために二分探索を使用します。

TUIキーバインド

• j/k: 上下に移動
• g/G: 先頭/末尾にジャンプ
• /: 検索
• Ctrl+R: 検索モードを切り替え（ファジー / グロブ / 正規表現）
• xまたはSpace: ファイル選択を切り替え
• Enter: ファイル詳細と差分を表示
• d: 差分モードを切り替え（ユニファイド / フルコンテキスト / 生データ）
• Ctrl+E: 選択したファイルを抽出
• q: 戻る / 終了

この種の復元ツールは、Claude Codeを頻繁に使用し、誤ったファイル削除や破損に対する保険を望む開発者にとって有用です。MITライセンスのこのプロジェクトは、執筆時点でGitHubで26スターと1フォークを獲得しています。