Turbo Quant Memory

AI コーディングエージェントのためのローカルファーストなメモリとナレッジグラフ

エージェントがファイルを何度も読み直したり、同じ結論を再び導き出したりすることはなくなります。
メモ、コード、シークレットがマシンの外に出ることはありません。

---

デモ

30秒のデモを見る

問題点

長時間のセッションでは、なぜそのコードがそのようになっているのかについて、苦労して得た詳細が蓄積されます。しかし、コンテキストが圧縮されると、それらは消えてしまいます。次のセッションでは、エージェントが同じファイルを読み直し、同じ結論を再び導き出し、同じトークンの料金をまた請求されます。

CLAUDE.md は数十行を超えると拡張が難しく、*「X について何を決めたのか、そしてその理由は何か？」*という質問にも答えられません。

Turbo Quant Memory は、エージェントが作業中に書き込める永続的で検索可能なストアを提供する MCP サーバーです。決定事項、教訓、パターン、セッションの引き継ぎに加え、Markdown のコンパクトなインデックスも保存できます。検索結果は文書全体ではなく約220文字のカードとして返され、カードだけでは不十分な場合に限り、エージェントが全文を読み込みます。

なぜこれを選ぶのか

	Turbo Quant Memory	mem0 / OpenMemory	MCP memory server
データの保存場所	常に自分のディスク	ベンダーのクラウドまたはセルフホスト可能	自分のディスク
データがホストの外に出るか	決して出ません	はい（セルフホストの場合を除く）	出ません
検索	ハイブリッド BM25 + 密ベクトル、RRF で融合	密ベクトル	完全一致のグラフ検索
検索結果	コンパクトなカード。必要に応じて詳細を取得	メモリー全体	ノード全体
ナレッジグラフ	あり — ライフサイクル管理と lint 機能付き	なし	あり
英語以外のコンテンツ	キリル文字の完全一致に標準対応	さまざま	該当なし
独自の削減量を計測	はい — server_info()	いいえ	いいえ
価格	無料、MIT	有料プラン	無料

HTTP クライアントも、テレメトリーも、外部への通信もありません。ご自身で確認できます — これは何も返しません。

grep -rnE '^[[:space:]]*(import|from)[[:space:]]+(requests|httpx|aiohttp|urllib3)\b' src/

例外を正確に説明すると、初回実行時に fastembed が Hugging Face から埋め込みモデル（約 0.22 GB）をダウンロードします。その後、サーバーは完全にオフラインで動作します。メモやコード、シークレットが外部に送信されることは決してありません — それらを送信できるものはパッケージ内に存在しません。

インストール

エージェントにインストールさせる

これを Claude Code、Codex、Gemini CLI、Cursor、または Antigravity に貼り付けてください：

このワークスペースに Turbo Quant Memory MCP サーバーをインストールして設定してください。 https://github.com/Lexus2016/turbo_quant_memory の手順に従い、 tqmemory サーバーを登録し、turbo-memory-mcp skill install を実行し、 ヘルスチェックを実行して、このプロジェクトをインデックス化してください。

skill install は、このマシン上のすべてのエージェントのスキルディレクトリに操作マニュアルをコピーします。これにより、今後のすべてのセッションで、指示しなくてもメモリーの使い方がわかるようになります。

または自分でインストールする

uv tool install turbo-quant-memory

0.27.x 以前からアップグレードする場合：0.28.0 で配布名が変更されたため、 uv tool upgrade turbo-memory-mcp では解決できなくなりました。代わりに一度 uv tool install --force turbo-quant-memory を実行し、その後は uv tool upgrade turbo-quant-memory を実行してください。turbo-memory-mcp コマンド自体は 変更されていないため、クライアントの設定は引き続き動作します。

次に、クライアントにサーバーを登録します：

claude mcp add --scope project tqmemory -- turbo-memory-mcp serve   # Claude Code
codex  mcp add tqmemory -- turbo-memory-mcp serve                   # Codex
gemini mcp add tqmemory turbo-memory-mcp serve                      # Gemini CLI

Cursor、OpenCode、Antigravity などのクライアント → CLIENT_INTEGRATIONS.md。 Hermes は systemd ゲートウェイ経由で MCP を実行します → docs/hermes.md。

📈 独自の削減量を計測 — 実際に確認できます

Turbo Quant Memory はトークンを節約すると主張するだけではありません。インストールごとに累積値が記録され、server_info()（フィールド usage_stats.headline）でいつでも確認できます。削減量は、こちらが約束するものではなく、ご自身で検証できます。

実際の開発者環境から取得した最新スナップショット（v0.28.2）：

メモリーの動作	数値
🔢 累計で節約した入力トークン数	約 2,640,000（増加中）
🔁 実行した検索	2,280 回の検索 + 280 回の詳細取得
📉 検索 1 回あたりの平均削減数	約 1,200 トークン
📚 管理対象のナレッジ	237 件のアクティブなメモ + 763 件のインデックス済みコードブロック
🛡️ 整合性	0 件の破損レコード · 0 件の保留中の移行

これらは 1 台のマシンでの累積値であり、合成ベンチマークではありません。エージェントの作業に応じて増えていく、独自のカウンターはゼロから始まります。インストール環境で server_info() を実行し、実際の数値を確認してください。

できること

• 型付きメモ。 decision、lesson、pattern、handoff — それぞれタグ、出典情報、対象のファイルまたは課題へのナレッジグラフリンクとともに保存されます。
• 階層型メモリ。 durable（決定事項、パターン）と reference（インデックス化されたドキュメント）はデフォルトで検索されます。episodic（セッションの引き継ぎ）は、求めるまで検索対象から外れるため、昨日の雑多な情報に重要なアーキテクチャ上の決定が埋もれることはありません。
• ハイブリッド検索。 高密度ベクトル検索を主軸に、BM25検索で関数名、ファイルパス、IDなどの正確な語句を補完し、相互ランク融合（Reciprocal Rank Fusion）で統合します。キリル文字やその他の英語以外の語句も、設定なしで大文字・小文字やアクセントの違いを無視して正確に一致します。
• ナレッジグラフ。 メモ、ファイル、課題の間の有向関係をタイムスタンプ付きで記録します。検索結果には関連するコンテキストがインラインで含まれるため、エージェントが別途検索する必要はありません。
• 人間のメモはエージェントのメモより優先されます。 明示的に記憶するよう依頼した内容には human-explicit のフラグが付き、関連性が同じ場合、エージェント自身の観察より上位に表示されます。
• 暗号化されたシークレット保管庫。 プロジェクト単位で管理され、AES-256-GCMで暗号化されており、構造上、検索からアクセスできません。→ docs/secrets-vault.md
• 小型マシンでも動作します。 デフォルトの埋め込みモデルは fastembed 経由の ONNX です。PyTorch は不要で、モデルは約0.22 GB、RAMは2 GBあれば快適に動作します。
• 1つのプロジェクトで複数のエージェントを自動連携。 同じgit作業ツリーで作業するエージェントは、互いのセッション、告知された作業内容、最近のファイル変更を確認できます。また、2つ以上のエージェントが同じツリーを共有している間は、テキストファイルへの変更が記録され、復元できます。設定は不要です。

技術的な詳細 → docs/features.md

1つのプロジェクトで複数のエージェントを使用する

同じ作業ツリーで複数のエージェントを実行すると、tqmemoryが自動的に連携します。設定は不要です。

• エージェント同士の情報を確認できます。 workspace_status には、アクティブなセッション、各エージェントが作業中だと告知した内容（announce_work、finish_work）、最近変更されたファイルが表示されます。tqmemoryの呼び出しが30分間なかったセッションは、代わりに idle_sessions に表示されます。このセッションはアクティブなピアではなく、告知された作業範囲も overlaps の対象外です。その他のtqmemoryの応答には、新しい出来事があった場合に限り、短い workspace メモが含まれます。セッションが1つだけの場合は含まれません。health と server_info には、常にワークスペース診断ブロックが含まれます。
• 変更が記録されます。 2つ以上のセッションが同じgit作業ツリーを共有している間、変更を検知したテキストファイルの新しいバージョンをウォッチャーが記録します（各ファイル最大1 MiBで、.gitignore または .tqmemoryignore に一致するものは除外されます）。短時間に複数回書き込まれた変更は、1つのバージョンにまとめられる場合があります。file_history でバージョンを一覧表示し、restore_file で復元できます。復元操作自体も取り消し可能です。ターミナルからも同じ操作を利用できます：turbo-memory-mcp files log と turbo-memory-mcp files restore。
• 制限事項。 バージョンは、2つ以上のセッションが同じgit作業ツリーを共有している間のみ記録されます。ジャーナルはgit作業ツリーの外、自分のホームディレクトリ、ファイルシステムのルートでは動作しません。デフォルトは、ファイルあたり1 MiB、プロジェクトあたり256 MiBの容量目標、保持期間14日です。記録されたバージョンは14日間復元可能です。それを過ぎた場合、またはプロジェクトが容量目標を超えた場合は、最も古いものから削除されます。過去24時間以内に変更された各ファイルの最新バージョンは、容量の都合で削除されることはありません。これらのデフォルト値は TQMEMORY_JOURNAL_MAX_FILE_BYTES、TQMEMORY_JOURNAL_MAX_BYTES、TQMEMORY_JOURNAL_RETENTION_DAYS で設定します。容量制限は目標値であり、厳密な上限ではありません。

これは部分的な保護であり、すべての変更が保存されることを保証するものではありません。書き込みをブロックする機能はありません。エージェント同士が互いの作業を上書きすることはあり、tqmemoryができるのは、その変更を表示して復旧を支援することだけです。tqmemoryを一度も呼び出さないエージェントには何も表示されません。動作するのは1台のコンピューター上だけです。無効にするには、TQMEMORY_WORKSPACE_DISABLE=1 を設定してください。

24 個の MCP ツール

グループ	ツール
書き込み	remember_note · deprecate_note · promote_note · index_paths
読み取り	semantic_search · hydrate · recent_context · list_scopes
グラフ	link_entities · unlink_entities · get_related_entities
衛生管理	lint_knowledge_base · health · self_test · server_info
ボルト	set_secret · get_secret · list_secrets · delete_secret
ワークスペース	announce_work · finish_work · workspace_status · file_history · restore_file

ドキュメント

MEMORY_STRATEGY.md	日々のメモリーの実際の使い方
CLIENT_INTEGRATIONS.md	クライアントごとのセットアップ：Cursor、OpenCode、Antigravity、…
TECHNICAL_SPEC.md	アーキテクチャとストレージ形式
docs/features.md	検索、グラフ、階層、埋め込みモデル、FTS 言語
docs/secrets-vault.md	ボルトのセットアップ、脅威モデル、FAQ
docs/hermes.md	Hermes ゲートウェイのセットアップとトラブルシューティング
CHANGELOG.md	リリース履歴

ライセンス

MIT。コピー、変更、フォーク、配布、クローズドソース製品への組み込み、販売が可能です。条件は著作権表示のみです。

言語

🇺🇸 英語 · 🇺🇦 ウクライナ語 · 🇷🇺 ロシア語