claude-find

必要な時に、Claude Codeの全セッションからディープメモリを呼び出します。

過去のすべてのClaude Codeセッションに対してセマンティック検索を行います。意味やキーワードに基づいてコンテキストを見つけ出します。圧縮された要約ではなく、生の会話トランスクリプトを検索するため、Claudeは推論、制約、失敗したアプローチ、決定事項など、全体像を把握できます。

セットアップ

brew install bun ollama
bunx claude-find setup

setupを実行すると、Ollamaが起動し、埋め込みモデルがプルされ、セッションの保持期間が永続に設定され、MCPサーバーがClaude Codeに登録されます。セッションは起動時にバックグラウンドでインデックス化されます。検索は即座に機能し、インデックス化が進むにつれて結果がより完全なものになっていきます。

BunとOllamaをインストールし、bunx claude-find setupを実行してください。プラットフォームを検出し、不足しているものがあればガイドが表示されます。

使用方法

Claude Codeのセッション内で以下のように使用します：

/find that database migration we discussed last week
/find why we chose websockets over polling
/find the session where we kept getting timeout errors
/find refactoring the payment module across all projects

Claudeは過去のセッションをセマンティックに検索し、関連する会話を見つけ出し、コンテキストを統合します。何が試され、何が失敗し、どのような制約を設定し、どのような決定がなされたかを把握します。

仕組み

1. インデックス化: ~/.claude/projects/にあるすべてのClaude CodeセッションJSONLファイルをインデックス化します。

2. 抽出: ユーザーとアシスタントのメッセージ、コンパクトな要約、ツール呼び出しからのファイルパスを抽出します。

3. 強化: 検索精度向上のため、各チャンクにメタデータコンテキスト（プロジェクト、ブランチ、ファイル、日付）を付与します。

4. 埋め込み: Ollama経由でqwen3-embeddingを使用して会話チャンクを埋め込みます（GPUアクセラレーション対応）。

5. 検索: Reciprocal Rank Fusion（RRF）を介して、ハイブリッドセマンティック検索とキーワード検索（FTS5）を統合します。

6. 返却: Claudeが完全なコンテキストで統合できるように、生の会話チャンクを返します。

アップグレード後は、bunx claude-find indexを実行して、最新の改善点を反映したインデックスを再構築してください。

特徴

• 生のトランスクリプトを検索: 圧縮によって情報が失われることはありません。

• 遡及的: 既存のすべてのセッションですぐに機能します。フックは不要です。

• 永続的な履歴: セットアップによりClaude Codeの30日間のセッションクリーンアップが無効化されるため、セッションを永久に検索可能です。

• ノンブロッキング: 起動時にバックグラウンドでインデックス化されます。インデックス化の途中であっても、検索は即座に機能します。

• コンパクトな要約を活用: Claude自身のセッション理解をランキングで強化します。

• ツール呼び出しのメタデータをインデックス化: 触れたファイルや発生したエラーで検索可能です。

• 高速: Ollama + GPUにより、インデックス化を高速かつメモリ制限内で維持します。

要件

• Bun ランタイム

• Ollama （初回使用時にモデルが自動ダウンロードされます）

• Claude Code

ライセンス

MIT