mneme Record

mneme Record

Claude Code 向けの Vault ネイティブなメモリです。Markdown が正本です。

毎回のセッションはゼロから始まります。同じアーキテクチャ、同じ制約、昨日すでに決めた同じ判断を何度も説明し直すことになります。それを解決すると謳うツールの多くは、会話履歴を不透明な SQLite の BLOB に保存し、セッションを終えるたびに LLM を呼び出します。自分の作業記録は、読めず、grep もできず、持ち出すこともできない場所に残されます。

mneme は、各 Claude Code セッションで起きたことを、所有するディレクトリ（Vault）内のプレーンな Markdown ファイルとして記録し、SQLite FTS5 でインデックス化します。次のセッションは、事前確認ブロックから始まります。そこには今日の見出し、git ステータスの要約、直近で更新されたセッション文書 5 件が含まれます。エージェントは必要に応じて mneme_search を使い、インデックスを検索します。

こちらは Stop フックが書き込むファイルです。フロントマター、見出し、要約の形式は packages/mneme-cc-plugin/src/mneme_cc_plugin/hooks/stop.py と packages/mneme-core/src/mneme_core/distill/templates/summary-en.md に基づいています。以下の内容は説明用の例です。

---
id: session-2026-07-24
type: session
created: 2026-07-24T09:12:41.087213+00:00
schema_version: 1
---
# Sessions 2026-07-24

## 09:12 session a3f19c2e
transcript: `~/.claude/projects/mneme/a3f19c2e.jsonl`

**Session intent**: make the retrieval guard fail on the negative probe too

**Files touched**

- `benchmarks/retrieval/regression_guard.py`
- `benchmarks/retrieval/baseline.json`

**Tool activity** (34 events, 08:41:02 → 09:12:38)

- Edit: 11
- Bash: 9
- Read: 8

*Deterministic extractive summary (zero-LLM). Edit freely — this file is yours.*

pipx install mneme-cc-plugin && mneme install

これによりプラグインがインストールされ、ライフサイクルフックが登録されます。mneme doctor で結果を確認できます。プロファイルとクライアントごとのインストールについては、3 層インストールを参照してください。Claude Code は 6 つのフックイベントを登録し、Codex と Antigravity は 4 つに対応付けます。それ以外の MCP クライアント（Kimi、Qwen、Cline、Cursor）では、オープンアダプターを通じて 10 個の MCP ツールを利用できますが、ライフサイクルフックも自動キャプチャもありません。

• 保存される内容は、開いて確認できるファイルです。 セッションによってボルト内の内容が実際に変更された場合、Stop フックはプロセス間ロックの下で原子的に書き込み、タイムスタンプ付きの ## HH:MM session ブロックを type: session のフロントマターとともに vault/sessions/YYYY-MM-DD.md に追記します。mneme index rebuild はボルト内のすべての Markdown ファイルを対象に FTS5 インデックスを再構築するため、データベースは削除しても問題のない派生状態です。
• セッションを終了するコストはゼロで、所要時間は 2 ms です。 「クリティカルパスで LLM を呼び出さない」という方針は、文章で約束するのではなく、CI で徹底しています。tools/spec_verify.py は6つすべてのライフサイクルフックモジュールを解析し、ネットワーク通信が可能な7つのルート（anthropic、openai、requests、httpx、urllib.request、urllib3、aiohttp）のいずれかをインポートしているとビルドを失敗させます。また、packages/mneme-cc-plugin/tests/integration/test_c3_no_network.py は、静的スキャンでは検出できない実行時に、ホットパス上の3つのフックの推移的なインポート全体を再確認します。Stop フックのプロキシベンチマークでは、100セッションで p95 が 2 ms となり、1000 ms の上限を下回ります。benchmarks/latency/p95_guard.py は、後述する同じパス対象のベンチマークワークフロー内でこの上限を徹底し、packages/mneme-cc-plugin/tests/unit/test_stop_performance.py は、パスフィルターのないすべての CI 実行で、実際の Stop 呼び出し100回を対象に再確認します。
• 検索品質が気付かないうちに低下することはありません。 本番用 FTS5 の nDCG@5 が固定ベースライン（0.8006、報告値は 0.801）を 0.02 超えて下回る場合、Recall@10 が 1.00 を 0.05 超えて下回る場合、または語彙外のネガティブプローブに失敗した場合、プルリクエストのビルドは失敗します。これは benchmarks/retrieval/regression_guard.py によって実施されます。このスクリプトは、packages/mneme-core、packages/mneme-mcp、benchmarks/、またはワークフローファイルに変更がある場合、すべてのプルリクエストと main へのすべてのプッシュで .github/workflows/bench.yml により実行されます。

適用範囲と制限

これらの数値は、MNEME_BENCH_SEED=42 でシード値を設定した、リポジトリ内のベンチマークスイートから得られたものです。ベンチマーク A では、500 ドキュメントのコーパスを使用します。ベンチマーク E では、デフォルトの 300 ドキュメント、30 クエリのフィクスチャを使用します。make bench-all で再現できます。上記の 0.801 と 2 ms の両方には、この README のすべての数値に適用される次の注記が付いています。

注記： 以下の数値はすべて、シード値を設定した合成コーパスで算出した決定論的な回帰アンカーであり、実環境における品質の測定値ではありません（ADR-012 を参照）。

検索に関する記述は、実際に到達可能な経路に基づいています。 本番の mneme_search 経路では FTS5 BM25 を使用します。Python コアには、実験的な特徴ハッシュ型の語彙ベクトルバックエンドと、ユニットテストおよび合成ベンチマークで使用する RRF フュージョンプロトコルが含まれていますが、このバックエンドは MCP サーバーやインストーラーには接続されていません。フルプロファイルでは、要約とタイムラインに、ゲート付きのローカル Graphiti および Neo4j のフィールドを追加できます。真のセマンティック埋め込みバックエンドは、引き続きロードマップ上の項目です。

プライバシーとネットワーク。 ステージング書き込み時にインラインの <private> タグを秘匿化し、SHA256 監査ログに記録します。オプトインの圧縮 LLM とオプションのローカル Neo4j を除き、外部へのネットワーク呼び出しはゼロです。圧縮はバックグラウンドで実行され、オプトイン制で、コスト上限が設けられています。

時間的推論。 決定論的なクレームライフサイクル（有効期間の開始／終了、上書き、as-of クエリ、矛盾の検出、来歴の時間遡行を行う temporal blame）は、すべてのプロファイルに組み込まれています。純粋な SQLite で動作し、追加の依存関係はありません。Graphiti へのエクスポートと LLM によるクレーム抽出は引き続きオプションであり、Stop 時やクリティカルパスでは実行されません。

コンテキスト継続エンジン（オプトイン）。 チェックポイントは Vault 内のプレーンな Markdown で、LLM を使用せず、デフォルトでは無効です。

Obsidian は完全にオプションです。 Vault は、Markdown ファイルを格納したプレーンなディレクトリにすぎません。mneme は特定のエディターや外部アプリケーションを必要とせず、Obsidian のインストールも不要です。grep、git、VS Code、または任意のテキストエディターを使って Vault を扱えます。「Vault」という用語は、自己完結した Markdown ディレクトリを指す慣用表現であり、特定のツールへの依存を意味するものではありません。Vault はプレーンな Markdown なので、すでに Obsidian を使用しているユーザーは、同じディレクトリを Obsidian で開き、mneme が書き込む Wiki リンクをレンダリングしたノート、バックリンク、グラフビューでのナビゲーションを利用できます。2 つのツールは問題なく共存します。mneme はすべての派生状態（インデックス、ステージング、監査ログ）を .mneme ディレクトリ内に保存し、Obsidian はこのドットフォルダーを無視します。また、mneme のインデクサーは .obsidian 設定フォルダーをインデックス対象から除外するため、どちらのツールも互いの動作を妨げません。Obsidian は Vault の内容を閲覧、ナビゲートするのに便利なツールです。mneme のキャプチャ、インデックス作成、検索の経路には含まれず、インストールの前提条件として扱ってはなりません。

出荷済み、ゲート付き、ロードマップ上の項目を網羅した一覧は実装状況にあります。mneme にまったく含まれていない機能については、2.0 ではまだ提供されないものに記載されています。

ステータス：4.1.0 の一般公開リリースです。パッケージ、プラグイン、ランタイム、引用、ドキュメントの各バージョン情報は、tools/version_bump.py によって常に同期されます（この行を含む 18 の情報源を CI で検証）。そのため、宣言されたバージョンが個別にずれることはありません。以前のバージョン系列からアップグレードする場合は、docs/UPGRADING.mdを参照してください。

ツール

MCP サーバーは 10 個のツールを登録します。MCP に対応するすべてのクライアントが 10 個すべてを利用できます。ライフサイクルフックと自動キャプチャは別のレイヤーであり、Claude Code、Codex、Antigravity のみが提供します。正式な一覧は packages/mneme-mcp/src/tool_registry.ts にあります。

ツール	機能
mneme_search	トルコ語の大文字・小文字を正規化したうえで、ボルト全体を対象に FTS5 BM25 検索を行い、日付、メモリタイプ、スコープによるフィルターも適用します。順位付けされた検索結果と、コンテンツハッシュ、信頼度、確信度、および実際に実行されたバックエンドを含む EvidenceCard を返します。
mneme_recall	セッション識別子、日付範囲、スコープを指定して、インデックス化されたドキュメントを取得します。パス、タイトル、更新日時、メモリタイプ、および任意で Markdown 本文全体を返します。
mneme_write	ボルト内のファイルにある Markdown セクションを、アトミックに追記または置換します。ボルトのパス内に限定し、保存前にプライベートな範囲を編集して伏せます。
mneme_summarize	FTS5 の検索結果を、任意の日付およびスコープのフィルターを適用して、ボルト内のディレクトリごとにグループ化します。Graphiti による拡充は、任意のローカルグラフ連携が設定されている場合にのみ表示されます。
mneme_timeline	対象に関するスコープ制限付きの参照情報を、時系列順に返します。Graphiti の事実と双時制フィルタリングは、任意のローカルグラフ連携が利用可能な場合にのみ表示されます。
mneme_prime	最近のセッションとトピックに関連する検索結果から、トークン予算に収まる事前コンテキストバンドルを作成します。呼び出し元のセッション識別子を指定すると、セッションごとの挿入の重複排除が有効になり、全文、要点、参照形式を選択できます。
mneme_propose	編集内容を伏せたメモリ編集の提案を、ポリシー処理キューに追加します。サーバーが編集を直接適用することはありません。永続カテゴリには、常に人間の承認が必要です。
mneme_checkpoint_list	アクティブなスコープから、Context Continuity Engine の最近のチェックポイントを新しい順に一覧表示します。チェックポイントの状態がない場合は、空のリストを返します。
mneme_working_set_load	Context Continuity Engine のチェックポイントから、重要度順のワーキングセット項目を読み込みます。不明なアンカーとスコープ外のアンカーには、同じ中立的な「見つかりません」結果を返します。

mneme との比較

Claude Code およびエージェントのエコシステムにおけるメモリツールは、それぞれ異なるトレードオフを選択しています。以下の表では、mneme が重視する項目について、アーキテクチャ上の機能を比較しています。また、他のツールが優れている項目も意図的に含めています。各セルは、各ツールのドキュメントから公開情報として確認できる設計特性を示しています。ベンチマークによる順位付けではありません。mneme の再現可能な数値については再現可能な数値を、ツールごとの詳細と「mneme が最適ではないケース」の正直な一覧についてはdocs/COMPETITIVE.mdを参照してください。

凡例：✓ 組み込み · gated 提供済みですが、依存関係またはフラグを有効にする必要があります · ~ 部分的 · — 利用不可 · n/a 該当なし。

項目	mneme	claude-mem	mem0	Letta	Zep	Supermemory
git diff と grep が使えるプレーンな Markdown ストア	✓	—	—	~	—	—
SHA256 監査機能を備えた組み込みの <private> マスキング	✓	—	—	—	—	—
LLM 呼び出しなしの決定論的な Stop 時キャプチャ	✓	—	n/a	n/a	n/a	n/a
通常のユーザーパスでのハイブリッド検索	~	~	~	~	✓	✓
時系列の主張ライフサイクル（有効期間、置き換え、変更者情報）	✓	—	~	~	✓	~
プロジェクトおよびコードグラフ（tree-sitter、PR への影響）	gated	~	—	—	—	—
適応型のトークンおよびコンテキスト予算	✓	—	—	—	—	—
エージェントのセキュリティ：機能ファイアウォール、汚染追跡、承認ゲート	✓	—	—	—	—	—
claude-mem からのワンコマンドでのロスレス移行	✓	n/a	—	—	—	—
ローカルファースト、クラウドアカウント不要	✓	✓	~	✓	—	—
Claude Code、Codex、Antigravity、あらゆる MCP クライアントで動作	✓	~	~	~	~	~
ライセンス	Apache-2.0	Apache-2.0	Apache-2.0	Apache-2.0	クラウド	オープンソース
Web グラフ UI によるチームメモリ（mneme：セルフホスト可能な Git 同期＋ローカルコンソール）	✓	—	~	—	✓	✓
エージェントが自身のメモリを自律的に書き換え（mneme：ポリシーに応じて段階的に実行、ロールバック、監査チェーン）	✓	—	~	✓	—	—
セッション終了時の自動要約、デフォルトで有効（mneme：決定論的、LLM 不使用）	✓	✓	—	—	~	~
ローカライズされた観察プロンプトのプリセット（mneme：英語＋トルコ語）	~	✓	—	—	—	—

3.0 系では、mneme 独自の方式で、従来の差分となっていた項目を解消しました。チームメモリは、ベンダーのクラウドではなく、ループバック接続のみの Web コンソールを備えたセルフホスト方式です（任意の Git リモート、共有前のマスキング、オプションの age エンドツーエンド暗号化に対応）。自律性はポリシーに応じて段階的に制御されます。エージェントは、オペレーターが許可した低リスクの編集クラスを自律的に適用します。変更はすべて記録され、ワンコマンドでロールバックでき、改ざんを検知できる HMAC 監査ログに連結されます。また、永続カテゴリでは常に人間が関与します。デフォルトで有効なセッション要約は決定論的で、LLM を使いません。キーも費用も遅延も不要で、より高度な処理を行うオプトインのレイヤーとして LLM による圧縮も利用できます。現在、英語とトルコ語のローカライズ済みプリセットを提供しています（対応言語数では依然として claude-mem が優位なため、正直に ~ としています）。ホスト型製品が実際により適した選択肢となる場合は、docs/COMPETITIVE.mdでその旨を説明しています。

実装状況

現在リリース済みの機能と、オプションのインフラが必要な機能、または今後のロードマップにある機能をひと目で確認できる一覧です。リリース済みは、デフォルトのインストール手順に含まれ、CI でテストされていることを意味します。条件付きは、実装済みですが、オプションの依存関係を用意するか、フラグを指定するまで無効であることを意味します。ロードマップは、設計済み（多くの場合、接続箇所やプロトコルもすでに用意されています）ですが、まだパッケージ化されていないことを意味します。

機能	状況	詳細
FTS5 BM25 検索（mneme_search）	リリース済み	デフォルトの MCP 検索パス
RRF 融合プロトコル	実験的	Python API と合成ベンチマークハーネスを提供。mneme_search には接続されていません
<private> の墨消しと SHA256 監査	リリース済み	Python と TypeScript のミラーを提供。ステージング書き込み
LLM を使用しない決定的な Stop キャプチャ	リリース済み	Stop フックが型付きセッションドキュメントを追記
適応型コンテキストレイヤー（シェル圧縮、インジェクション重複排除、適応型 top-k）	リリース済み	distill.* サブシステム
パターンと軌跡のメモリー	リリース済み	vault-markdown プリミティブ
Claude Code／Codex／Antigravity ネイティブプラグイン	リリース済み（ネイティブ）	Claude Code は 6 つのフックイベントを登録。Codex と Antigravity は 4 つをマッピング。2 つのスキルと MCP
オープン MCP アダプター（Kimi、Qwen、あらゆる MCP クライアント）	リリース済み（非ネイティブ）	MCP ツールのみ。自動キャプチャには対応していません
バックグラウンド AI 圧縮	リリース済み（オプトイン、デフォルトでは無効）	月次コスト上限台帳
特徴量ハッシュを用いた語彙・ベクトル検索	実験的、未接続	Python コアとベンチマークに実装済み。インストーラーや MCP のユーザー向け経路は文書化されていません
時間的な claim ライフサイクル、ルールベースの claim 抽出、temporal blame	リリース済み	Graphiti へのエクスポートは条件付き。LLM による抽出はオプションで、Stop／クリティカルパスでは決して実行されません
プロジェクトとコードのグラフ（mneme-graph）	リリース済み（別パッケージ）	tree-sitter による Python／JavaScript／TypeScript の抽出、コミュニティ検出、PR 影響分析、エンティティの正規化
コードメモリー（mneme-code）	リリース済み（別パッケージ）	AGENTS.md の手順解析、テスト出力からの失敗メモリー、修正軌跡
ドメインモード	リリース済み	vault-config のユーザーモードと CLI。臨床モードとセキュリティレビュー用モードでは、外部への抽出とアーティファクトのアップロードをブロックします。ユーザー設定で組み込みのプライバシーモードを弱めたり、墨消しを無効にしたりすることはできません
エージェントのセキュリティ	リリース済み	機能ファイアウォール、データフローの汚染追跡、永続的な編集に対する人間の承認ゲート、汚染された vault のベンチマーク
読み取り専用コンソール	リリース済み	自己完結型でオフライン対応、インジェクションに安全な HTML 監査レポート
コネクター（Obsidian ローカル＋GitHub のインジェクション済みトランスポート）	リリース済み（オプトイン、デフォルトでは無効）	取り込み前に墨消しを実行。無効化して取り消し可能
ライブ Neo4j／Graphiti 書き込みによる KG の時間的情報拡充（summarize／timeline）	条件付き	フルプロファイル：Docker＋Neo4j
パッケージ化されたセマンティック埋め込みアダプター	ロードマップ	アダプタープロトコルは用意済み。パッケージ化されたセマンティックモデルや、本番 MCP への接続はありません
Web ベースのナレッジグラフ視覚的探索ツール	ロードマップ	予定されています
マルチユーザーのチーム機能（マージ競合の解決、ユーザーごとの ACL、ダッシュボード）	ロードマップ（Team）	git リモートを使った読み取り専用の共有 vault は現在も利用できます

再現可能な数値

これらの数値は、MNEME_BENCH_SEED=42 を設定して実行する、リポジトリ内のベンチマークスイートから得られたものです。ベンチマーク A では 500 ドキュメントのコーパスを使用します。ベンチマーク E では、デフォルトの 300 ドキュメント、30 クエリのフィクスチャを使用します。make bench-all で再現できます。

注記： 以下の数値は、シード付き合成コーパスで計算された決定論的な回帰アンカーです。実環境での品質測定値ではありません（ADR-012 を参照してください）。

ベンチマーク	指標	結果
A. 検索品質	nDCG@5、production FTS5	0.801（Recall@10 1.00、MRR 0.734）
B. Stop フックのレイテンシ	p95	2 ms（制約予算 1000 ms）
B. Retrieve のレイテンシ	p95	3 ms（インデックス化された 500 ドキュメントのコーパス）
C. シェル出力の圧縮	削減率	88 percent（冗長な Bash ログ）
C. インジェクションの重複排除	スキップ率	95 percent（20 ターンの短いセッション）
C. 圧縮形式	削減率	全体と比較して keypoints 46 percent、ref 88 percent
D. 移行ツール	アサーション	4 件中 4 件成功（移行、冪等性、重複排除、秘匿化）
E. アダプターの直接比較	mneme 側	nDCG@5 0.831、MRR 0.772（300 ドキュメントのフィクスチャ）

CI の回帰ガードは、パス単位で対象を絞ったベンチマークの範囲を固定します。ベンチマーク対象コードに触れるプルリクエストでは、ベンチマークのワークフローが実行されます。production FTS5 を使用するベンチマーク A の nDCG@5 が 0.02 を超えて低下する実行、または Stop フックの p95 が 1000 ms を超える実行は、ビルドを失敗させます。BoW RRF の条件は、語彙的代理指標によるアブレーションとしてのみ報告されます。

3 段階のインストール

# Lite: FTS5 + Stop hook + privacy redaction + 10 MCP tools (Python + Node only)
pipx install mneme-cc-plugin
mneme install --profile=lite

# Standard: lite plus the standard optional dependency profile.
# The normal MCP search path remains FTS5. No --enable-dense installer flag ships.
mneme install --profile=standard

# Full: standard + gated Graphiti temporal knowledge graph enrichment (Docker + Neo4j)
mneme install --profile=full

データを失わずに、その場でアップグレードします。

mneme upgrade --profile=standard

インストールが正常であることを確認します。

mneme doctor

Codex で mneme を使用する

mneme は、Claude Code ネイティブとして開発されました。検索コア（mneme-core）、MCP サーバー（mneme-mcp）、および Vault の仕様はクライアントに依存しないため、mneme は忠実度を損なうことなく、OpenAI Codex CLI 内で追加レイヤーとしても動作します。

# Plugin: skills, MCP server, and lifecycle hooks together
codex plugin marketplace add OnourImpram/mneme

# Or wire just the MCP server into ~/.codex/config.toml
mneme install --client=codex

Codex では、同じ 10 個の MCP ツール、同じ 2 個のスキル、同じ Vault を利用できます。登録されている mneme の 6 つの Claude Code フックイベントのうち 4 つは、Codex のネイティブなライフサイクルイベント（SessionStart、PostToolUse、Stop、PreCompact）に対応し、SessionEnd は Stop に統合されます。UserPromptSubmit に対応する Codex のイベントはありません。対応範囲の全表については docs/CODEX.md を、マルチクライアント設計については docs/ARCHITECTURE.md の ADR-014 を参照してください。

Antigravity で mneme を使用する

Antigravity（Google のエージェント型 IDE）は Gemini-CLI 拡張機能モデルを使用しており、mneme にはネイティブ拡張機能が用意されています。

mneme install --client=antigravity

これにより、mneme 拡張機能が ~/.gemini/extensions/ にインストールされ、同じ 10 個の MCP ツール、同じ 2 個のスキル、GEMINI.md ルールファイル、およびライフサイクルフック（SessionStart、PostToolUse、Stop、PreCompact）が設定されます。これらのフックは、Claude Code や Codex と同じ mneme hook <event> コアパスに対応します。Antigravity は Stop フックを公開しているため、セッションのキャプチャーはネイティブと完全に同等です。

その他の MCP クライアント（オープンアダプター）

MCP 対応クライアント（Kimi、Qwen、Cline、Cursor など）であれば、オープンアダプターを介して mneme を利用できます。これはネイティブではないティアです。モデルから呼び出せる 10 個の MCP ツールを利用できますが、ライフサイクルフックと自動キャプチャーはありません。

mneme install --client=mcp --config <path-to-your-clients-mcp-config.json>

mneme は自身のサーバーエントリーのみをマージし、設定内のその他のサーバーには手を加えません。クライアントのティア分けの詳細は docs/INTEGRATIONS.md を、設定例とポータブルな AGENTS.md テンプレートは examples/ を参照してください。

2.0 のリリース内容

• 10 個の MCP ツール：mneme_search、mneme_recall、mneme_write、mneme_prime、mneme_summarize、mneme_timeline、mneme_propose、mneme_health、mneme_checkpoint_list、mneme_working_set_load。デフォルトの検索方式は FTS5 です。mneme_health は、インデックスのスキーマと経過期間、インデックスが保持するロケールプロファイル、ドキュメント数、ステージングの深さなど、インストール環境自体の状態を報告し、各警告に対処法を付記します。フルプロファイルの summarize と timeline では、ローカルグラフが有効な場合に KG フィールドを追加できます。mneme_checkpoint_list と mneme_working_set_load は Context Continuity Engine（CCE）に対応し、利用可能なワーキングセットのチェックポイントを一覧表示し、重要度順に並べたチェックポイントの項目を読み込んで、JIT コンテキストを再注入します。
• 5 つの Claude Code フック：PostToolUse、SessionStart、Stop、PreCompact、SessionEnd。
• 3 つのスラッシュコマンド：/mneme:prime、/mneme:recall、/mneme:migrate。
• 2 つのスキル：mneme-prime、mneme-search。
• 7 つのベンチマークスイート（make bench-all）：検索品質（A）、Stop／検索のレイテンシ（B）、適応型コンテキストのコスト（C）、claude-mem の移行（D）、アダプターの直接比較（E）、LongMemEval（F）、CCE のコンパクション・検索（G）。
• 1 コマンドでの移行：mneme-migrate migrate-from-claude-mem。3 状態のアーカイブフラグ、冪等な再実行、実行ごとにハッシュ検証されるロールバックマニフェストを備えています。
• 適応型コンテキストレイヤー：distill.shell_compress、distill.injection_dedup、distill.adaptive_topk、distill.compressed_format。トークンレポート用の mneme audit と、編集監査エントリ用の mneme audit-log も利用できます。
• パターンメモリー：mneme patterns {store, search, list, show, delete} を使用して、シグナル／アクション／結果のドキュメントを vault-markdown 形式で書き込みます。
• 軌跡レコーダー：mneme trajectory {start, step, end, show, list} を使用して、セッションごとの意思決定の軌跡を vault/trajectories/ に記録します。
• バックグラウンド AI 圧縮（オプトイン、デフォルトでは無効）：月次コスト上限の台帳を備えた mneme compress {enable, disable, status, dry-run, run}。

2.0 の上級機能群

8 つのモジュールで mneme のコアを拡張し、特化したワークロードに対応します。すべて、機能制限の対象であるか、別パッケージとして提供されます。すべてのモジュールで、保存前の編集、すべてのレコードの出所情報、抽出されたすべての主張への信頼度ラベルに対応しています。いずれも Stop 時やクリティカルパスでは実行されません。

• プロジェクトグラフ（mneme-graph）：Python、JavaScript、TypeScript の tree-sitter 抽出、コミュニティ検出、PR 影響分析、エンティティの正規化。
• コードメモリー（mneme-code）：AGENTS.md の手順解析、テスト出力からの障害メモリー生成、修正軌跡の記録。
• ドメインモード：臨床モードとセキュリティレビュー・モードでは、設定レイヤーで外部への抽出とアーティファクトのアップロードをブロックします。ユーザー設定によって、組み込みのプライバシーモードを弱めたり、編集を無効にしたりすることはできません。
• エージェントセキュリティ：機能ファイアウォール、データフローの汚染追跡、永続的な編集に対する人間の承認ゲート、汚染された vault のベンチマーク。
• 読み取り専用コンソール：サーバー不要で、単体で動作し、オフラインかつインジェクション耐性を備えた HTML 監査レポート。
• 実験的な特徴ハッシュ型の字句・ベクトル検索：テストと合成ベンチマークで使用する Python コアバックエンドと RRF の接続点。インストーラーや本番環境の MCP 検索経路には接続されていません。
• 時間情報の抽出と Graphiti エクスポート：ルールベースの主張抽出、有効期間の開始／終了、置き換えリンク、ローカルの Graphiti インスタンスへのエクスポートに対応します。LLM による抽出は任意で、クリティカルパスでは決して実行されません。Neo4j へのライブ書き込みは、Docker と Neo4j のフルプロファイルでのみ有効になります。
• コネクター（Obsidian ローカル + GitHub の注入型トランスポート）：オプトインで、デフォルトでは無効です。取り込みの前に必ず編集を実行します。設定で無効にすると、接続を解除できます。

2.0でまだ提供されていないもの

「市場最高」という主張には、対象範囲を誠実に認めることが必要です。

• パッケージ化されたセマンティック埋め込みバックエンドも、インストールして使える高密度検索のユーザーパスもありません。特徴量ハッシュを用いた語彙ベクトル実装は、引き続き実験的な Python API です。
• mneme_search には高密度検索も KG もありません。MCP 検索は FTS5 です。KG エンリッチメントは、ローカルのフルプロファイルグラフ状態が有効な場合に限り、要約とタイムラインで利用できます。
• クラウド SaaS オプションはありません。mneme はアーキテクチャ上の信念に基づき、ローカルファーストです。
• Web ベースのナレッジグラフ可視化エクスプローラーはありません。提供を予定しています。
• マージコンフリクト解決、ユーザーごとの ACL、チームダッシュボードを備えたマルチユーザー向けチーム機能はありません。git remote を介した読み取り専用の共有 Vault は現在利用できます。完全なチーム対応はロードマップに含まれています。

全体像と、こうしたニーズにより適している可能性のあるツールについては、docs/COMPETITIVE.md をご覧ください。

ドキュメント

• docs/ARCHITECTURE.md：設計思想と16件のアーキテクチャ決定記録（ADR-001～ADR-016。ADR-006はADR-015に置き換えられています）。
• docs/CONSTRAINTS.md：6つの重要な制約と、それぞれの検証方法。
• docs/VAULT.md：Vault の仕様、frontmatter の仕様、アトミック書き込みパターン。
• docs/HOOKS.md：フック統合ガイド、時間予算、フェイルソフトの仕様。
• docs/MCP.md：JSON スキーマと呼び出し例を含むツール API リファレンス。
• docs/RELEASE.md：GitHub タグ、リリース、メタデータのチェックリスト。
• docs/COOKBOOK.md：Claude Code の完全なトランスクリプトを含む、手順付きレシピ10件。
• docs/MIGRATION-FROM-CLAUDE-MEM.md：3状態アーカイブとハッシュ検証付きロールバックの手順を含む、1コマンドでの移行。
• docs/BENCHMARKS.md：手法と固定済みのベースライン数値。
• docs/COMPETITIVE.md：継続的に更新される市場動向ドキュメント（月次更新）。
• docs/PRIVACY.md：外部ネットワーク呼び出しの監査とテレメトリーポリシー（デフォルトではゼロ）。
• docs/GOVERNANCE.md：メンテナンスモデル、リリース権限、継承。

ライセンス

Apache License 2.0。LICENSE と NOTICE をご覧ください。2.x 系までのリリースは MIT の下で公開されており、引き続き MIT ライセンスが適用されます。

謝辞

Onour Impram（@OnourImpram）がメンテナンスしています。Adaptive Context Layer とパターンおよび軌跡のプリミティブは、本番環境の社内ツールで実証されたトークン圧縮とエージェント DB のパターンから、概念的な着想を得ています。アーキテクチャは mneme 固有のものであり、その系譜は運用経験に基づいています。