会話履歴の検索

過去の Claude Code セッションのインデックス付きアーカイブを検索する search_conversations という MCP ツールにアクセスできます。

使用時機

• ユーザーが「X について何を決めたのか？」と尋ねる場合
• ユーザーが「Y のバグをどのように修正したのか？」と尋ねる場合
• ユーザーが「このようなことに以前取り組んだことはあるか？」と尋ねる場合
• ユーザーが「プロジェクト Z はどこまで進んだのか？」と尋ねる場合
• ユーザーが過去の会話を参照して検索したい場合
• 現在の作業を判断するために以前のセッションからのコンテキストが必要な場合

ワークフロー

1. 検索 — 自然言語クエリで search_conversations を呼び出す
2. 結果を確認 — 各結果には context（そのチャンクが何についてのものかを示すHaiku生成のサマリー）、chunk_preview（最初の約 300 文字）、および turn_range（セッションのどの部分か）が含まれます
3. ソースを読む — clean_log_path で Read を使用して完全なセッショントランスクリプトを読みます。turn_range を使用して関連セクションに移動します。
4. ユーザーに回答 — 発見した内容を統合して答えます。

検索のコツ

• 自然言語を使用します。「auth ミドルウェアについて何を決めたのか」は、キーワード詰め込みより効果的です
• 最初の結果が関連していない場合は、別の言い方を試します。「認証アプローチ」対「auth ミドルウェアの決定」
• context フィールドが最も情報量が多くなります。各チャンクが何をカバーしているかについての Haiku 生成の説明です
• 結果は関連性スコアでランク付けされます。数値が高いほど関連性が高くなります。
• 各セッションから複数のチャンクが返される可能性があります。session_id を見て、同じセッションの結果をグループ化します。

結果を読む

各検索結果には以下が含まれます：

• clean_log_path — クリーンな Markdown トランスクリプトへの絶対パス。このファイルで Read ツールを使用して完全なコンテンツを取得します。
• turn_range — 例：「turns 5-8」はファイル内のマッチがおよそどこにあるかを示します
• context — Haiku 生成の説明（迅速な評価に最も有用）
• chunk_preview — マッチするチャンクの最初の約 300 文字
• date、cwd、first_user_message — 向き付けのためのセッションメタデータ

インデックスされているもの

claude-log-search index で明示的にインデックスされたセッションのみが検索可能です。index_status を使用してインデックスにいくつのセッションがあるかを確認します。セッションがインデックスされていない場合は、ユーザーに以下を実行するよう指示します：

claude-log-search index --limit 10

これにより、最近の 10 個のセッションがインデックスされます（コンテキスト生成のため各セッションは約 30 秒かかります）。

制限事項

• インデックスには会話履歴のすべてが含まれていない可能性があります。インデックスされたものだけが対象です
• 非常に最近のセッション（今日のセッション）はまだインデックスされていない可能性があります
• 検索品質は Haiku 生成のコンテキスト説明に依存します
• セッション内の最初の検索はモデルの読み込みに約 5～10 秒かかります（その後の検索は高速です）