bettermemory

コーディングエージェント向けのMCPメモリーサーバーです。保存された事実は、モデルがそれを利用する前にファイルシステムとGitで確認されるため、古くなったメモリーはそのまま引用されるのではなく、警告されます。

インストール

Claude Code — スラッシュコマンドを2つ追加するだけで、設定は不要です。

/plugin marketplace add 0Mattias/bettermemory
/plugin install bettermemory@bettermemory

MCPに対応するその他のクライアント：

uv tool install bettermemory
bettermemory init --client claude-desktop   # or cursor / cline / claude-code / hermes

クライアントを再起動してください。正しく接続されていればbettermemory doctorは終了コード0を返し、問題があれば修正方法を1行で表示します。

インストールせずに試すには、uvx bettermemory tryを実行します。ファイルを引用するメモリーを書き込み、そのファイルを削除してから、次の検索でそのメモリーにフラグが付く様子を表示します。オフラインで使用できる一時的なストアです。

機能

• 信頼する前にメモリーを確認します。検索結果にはすべて、古さに関する判定が付いています。暦上の経過時間、引用されたパスがまだ存在するかどうか、最後に確認されてからコミットされた内容、そして記録がどのようにストアに追加されたか（ここで作成、取得、手動で配置）を確認します。 宣言された主張 （path、path::symbol、path::NAME=literal）は作業ツリーと照合して再確認されます。正しくなくなった主張があると、そのまま記録されるのではなく、確認のスタンプがブロックされます。
• 検索結果の取得は意図的に行います。メモリーはツール呼び出しであり、注入ではありません。書き込みゲートは、一時的な状態、秘密情報らしきトークン、類似した重複を拒否します。あなた自身についての主張は推論としてラベル付けされるため、事実と区別して修正できます。
• モデルの代わりになるのはコードです。検索は、独自の語彙を対象にしたキーワード検索とBM25を融合した、決定論的な語彙ランキングです。埋め込みモデルもダウンロードも不要で、事前の準備もなく、毎回同じ結果が得られます。
• ファイルはシンプルです。メモリーごとにMarkdownファイルを1つ使用します。grepで検索でき、Gitで同期でき、クラウドもアカウントも不要です。ファイルの横にあるSQLiteインデックスは削除可能な派生キャッシュで、bettermemory reindexで再構築できます。
• 古くなった情報は蓄積させず、対処します。エピソードはセッションごとの実行状態を記録し、永続的な検索に混入させません。ヘルステレメトリーとキュレーションツールにより、変化した内容、古くなった内容、矛盾している内容を把握できます。
• 形容詞ではなく、根拠を示します。上記の主張は、事前登録されたベンチマークで測定しています。見落としも含む、凍結済みの結果アーティファクトはbench/（results/*.json。それぞれ、スコア算出に用いた宣言済みの用語を記録）に保存されており、bettermemory evalでは独自のログに照らして、メモリーが実際に役立ったかを評価できます（評価結果を公開しています）。

エージェント向け

このリンクを「これをセットアップして」と渡されたのではないでしょうか。Claude Code では、 上記の2つのプラグインコマンドだけでインストールは完了します。ステップ3に進んでください。 それ以外の場合、各ステップは冪等で、安全に再実行できます。

1. uv tool install bettermemory — または pipx install bettermemory、 あるいは仮想環境に pip install bettermemory を実行します。Python 3.11–3.14 が必要です。
2. bettermemory init --client claude-code — 同様に claude-desktop、cursor、cline、hermes も指定できます。それ以外の MCP ホストでは、引数なしの bettermemory init を実行すると、標準の mcpServers JSON スニペットと 既知の設定場所が表示されます。（Continue では手書きの YAML エントリーが必要です。docs/clients.md を参照してください。）
3. bettermemory doctor — 終了コードが 0 なら正しく接続されています。失敗した チェックには、修正方法が1行で表示されます。
4. サーバーを読み込ませるためにクライアントを再起動してもらい、モデルに 「どんなメモリツールが使えますか？」 と尋ねて確認します。

ツールのシグネチャ、検索の指針、 書き込みの制限など、運用上の契約については docs/api.md を参照してください。サーバーの instructions ブロックが、基本ポリシーを自動的に適用します。システムプロンプトに 詳細なポリシーを追加するには、bettermemory init --with-addendum を実行します。Claude Code の組み込み自動メモリから移行する場合は、 bettermemory ingest を実行すると、これらのファイルを一度だけインポートできます。

その他のすべて

その他の情報もすべて文書化されています。仕組み、ストレージ形式、ツールの 全機能、CLI、設定、制限事項については internals、クライアントごとのセットアップについては clients と installation、評価方法については eval、 事後分析については incidents、リリース履歴については CHANGELOG、開発環境のセットアップと互換性に関する契約については CONTRIBUTING を参照してください。

MIT ライセンスです。詳細は LICENSE を参照してください。