Memento Vault：Claudeコードセッションの永続的コンテキストのためのローカルツール

Memento Vaultは、Claude Codeがセッション間でコンテキストを忘れてしまう問題に対処し、手動でのメンテナンスなしに関連情報を自動的にキャプチャ・検索します。

仕組み

このツールは、Claude Codeのライフサイクルに接続するフックを使用します：

• セッション終了時： フックがトランスクリプトを読み取り、スコアリングし、何を保持するかを決定します。重要なセッションでは、アトミックノートがローカルのgitリポジトリに書き込まれます。各ノートには、確実性スコアやタグを含むフロントマターと関連ノートへのウィキリンクが付いた1つのアイデアが含まれます。些細なセッションでは、日次ログに1行の記録が残されます。
• セッション開始時： プロジェクトの最近のセッションと、これから作業する内容に関連する最も重要な保管庫ノートを示すブリーフィングを注入します。
• すべてのプロンプト時： 保管庫を検索し、Claudeが入力内容を処理する前に一致するノートを表示します。
• すべてのファイル読み取り時： 以前に触れたコード領域に関するコンテキストを注入します。

技術詳細

すべての検索は、LLM呼び出しなしでローカルのBM25 + ベクトル検索を使用します。システムのプロンプトあたりの平均レイテンシは472msで、実行コストはゼロです。コンテキストのオーバーヘッドは、セッションあたり約149入力単位です。検索品質は、LongMemEval（500問）でNDCG@10 = 0.892のスコアを記録しています。

Inceptionと呼ばれるバックグラウンド統合レイヤーは、埋め込み類似性によってノートをクラスタリングし、セッション後にパターンノートを書き込み、プロジェクト間で繰り返される問題を特定します。

システム全体は、gitリポジトリ内のマークダウンファイルを使用しており、Obsidianで閲覧可能、grepで検索可能、git logで差分確認可能です。データベース、Docker、クラウド依存はありません。

インストール

git clone https://github.com/sandsower/memento-vault.git
cd memento-vault
./install.sh --experimental

要件：Python 3とClaude Code。QMDはセマンティック検索を追加します（オプション）。LinuxとmacOSで動作します。

プロジェクトには271のテストが含まれており、MITライセンスです。