Claude Code History Files Finder

~/.claude/projects/ に保存されている Claude Code のセッション履歴ファイルからコンテンツを抽出・復旧します。

機能

• 前回のセッションから削除または紛失したファイルを復旧
• 会話履歴全体から特定のコードやコンテンツを検索
• 過去のセッション間でのファイル変更を分析
• ツール使用とファイル操作の時間経過を追跡
• 特定のキーワードやトピックを含むセッションを検索

セッションファイルの場所

セッションファイルは ~/.claude/projects/<normalized-path>/<session-id>.jsonl に保存されています。

JSONL 構造と抽出パターンの詳細については、references/session_file_format.md を参照してください。

コア操作

1. プロジェクトのセッションを一覧表示

特定のプロジェクトのすべてのセッションファイルを検索します：

python3 scripts/analyze_sessions.py list /path/to/project

最新のセッションをタイムスタンプとサイズとともに表示します。

オプション：--limit N で N 個のセッションだけを表示（デフォルト：10）。

2. セッションからキーワードを検索

特定のコンテンツを含むセッションを検索します：

python3 scripts/analyze_sessions.py search /path/to/project keyword1 keyword2

キーワード頻度でランク付けされたセッションを以下の情報とともに返します：

• 総メンション数
• キーワード別の内訳
• セッション日時とパス

オプション：--case-sensitive で完全一致検索。

3. 削除されたコンテンツを復旧

セッション履歴からファイルを抽出します：

python3 scripts/recover_content.py /path/to/session.jsonl

すべての Write ツール呼び出しを抽出し、元のディレクトリ構造を保存しながら ./recovered_content/ に保存します。

キーワードでフィルタリング：

python3 scripts/recover_content.py session.jsonl -k ModelLoading FRONTEND deleted

パス内のいずれかのキーワードに一致するファイルのみを復旧します。

カスタム出力ディレクトリ：

python3 scripts/recover_content.py session.jsonl -o ./my_recovery/

4. セッション統計を分析

詳細なセッションメトリクスを取得します：

python3 scripts/analyze_sessions.py stats /path/to/session.jsonl

レポート内容：

• メッセージ数（ユーザー/アシスタント）
• ツール使用の内訳
• ファイル操作数（Write/Edit/Read）

オプション：--show-files ですべてのファイル操作をリスト表示。

ワークフロー例

ファイル復旧、ファイル進化の追跡、バッチ操作を含む詳細なワークフロー例については、references/workflow_examples.md を参照してください。

復旧のベストプラクティス

重複排除

recover_content.py は自動的に各ファイルの最新バージョンのみを保持します。ファイルがセッション内に複数回書き込まれた場合、最終バージョンのみが保存されます。

キーワード選択

以下に含まれる独特のキーワードを選択してください：

• ファイル名またはパス
• 関数/クラス名
• コード内の一意の文字列
• エラーメッセージまたはコメント

出力の整理

説明的な出力ディレクトリを作成してください：

# 悪い例
python3 scripts/recover_content.py session.jsonl -o ./output/

# 良い例
python3 scripts/recover_content.py session.jsonl -o ./recovered_deleted_docs/
python3 scripts/recover_content.py session.jsonl -o ./feature_xy_history/

検証

復旧後は常にコンテンツを検証してください：

# ディレクトリ構造を確認（ファイルはサブディレクトリに保存）
find ./recovered_content/ -type f

# 復旧レポートを読む（出力パス全体を表示）
cat ./recovered_content/recovery_report.txt

# コンテンツをサンプル確認（レポートから実際のパスを使用）
head -20 ./recovered_content/src/components/ImportantFile.jsx

制限事項

復旧できるもの

✅ Write ツールで書き込まれたファイル ✅ Markdown ブロックに表示されたコード（部分抽出） ✅ Edit/Read 操作からのファイルパス

復旧できないもの

❌ ディスクに書き込まれたことがないファイル（議論のみ） ❌ セッション開始前に削除されたファイル ❌ バイナリファイル（画像、PDF）- パスのみ利用可能 ❌ セッションでキャプチャされていない外部ツール出力

ファイルバージョン

• Write ツールが呼び出されたときの状態のみをキャプチャ
• Write 呼び出し間の中間編集は失われます
• Edit 操作は差分を表示し、完全なコンテンツではありません

トラブルシューティング

セッションが見つからない

# プロジェクトパスの正規化を確認
ls ~/.claude/projects/ | grep -i "project-name"

# 実際のプロジェクトディレクトリを確認
ls -la ~/.claude/projects/

復旧が空である

考えられる原因：

• ファイルは編集（Edit ツール）されたが、書き込まれていない（Write ツール）
• キーワードがセッション内のファイルパスと一致しない
• セッションがファイル作成より前の日付

解決策：

• --show-edits フラグを使用して Edit 操作を確認
• キーワード検索を広げる
• 隣接するセッションを検索

大規模なセッションファイル

100MB を超えるセッションの場合：

• スクリプトはストリーミングを使用（行単位処理）
• メモリ使用量は一定
• 処理に 1～2 分かかる場合があります

セキュリティとプライバシー

復旧したコンテンツを共有する前に

セッションファイルには以下が含まれる場合があります：

• ユーザー名を含む絶対パス
• API キーまたは認証情報
• 企業固有の情報

共有する前に必ずサニタイズしてください：

# 絶対パスを削除
sed -i '' 's|~/|<home>/|g' file.js

# 認証情報がないか確認
grep -i "api_key\|password\|token" recovered_content/*

安全な保管

復旧されたコンテンツは元のセッションから感度を継承します。セッションデータ処理に関する組織のポリシーに従い、安全に保管してください。

次のステップ：中断した作業を再開

関連するセッション履歴を見つけた後、作業を継続することを提案してください：

[N] 個の復旧可能なコンテキストを含む関連セッションが見つかりました。

オプション：
A) 作業を再開 — /continue-claude-work を実行して中断したところから再開（推奨）
B) コンテンツだけを表示してください — 自分で判断します