Perseus Vault

AIエージェントのための、持続的で暗号化された記憶。単一のRustバイナリ、単一のファイル、クラウド不要。

公開先 Official MCP Registry · Glama · mcpservers.org · Lulu MCPs · Docker (GHCR)

エージェントにセッションを超えて持続する記憶を与え、すでに学習したことを再導出する手間や、過去の過ちを繰り返すことを防ぎます。ハイブリッド検索（BM25 + 密ベクトル + RRF）、二時点履歴、保存時のAES-256-GCM暗号化を、168個の標準MCPツールとして公開し、任意のホストで動作します。レガシーな mimir_*/mneme_* エイリアスは2026-27メジャーリリースで削除され、別途カウントされません。LongMemEval公式ハーネスで73.8%（Zep 63.8%、Mem0 49.0%と比較）。 単一バイナリ。単一ファイル。Docker不要。Postgres不要。クラウド不要。 ローカルファースト、エアギャップ対応、MITライセンス。

一行インストール

curl -sSf https://raw.githubusercontent.com/Perseus-Computing-LLC/perseus-vault/main/scripts/install.sh | sh

以上です。Perseus Vault は ~/.local/bin/perseus-vault にインストールされます。起動するには：

perseus-vault serve --db ~/.perseus-vault/data/perseus-vault.db

デフォルトインストールでは暗号化が自動的に有効になります。 初回実行時に、所有者のみアクセス可能な ~/.perseus-vault/secret.key と、暗号化されたデータベースカナリアが作成されます。そのキーはバックアップしてください：復元は不可能です。明示的な --encryption-key パスは引き続きサポートされており、既存のプレーンテキストデータベースは perseus-vault init --rekey による移行のために保持されます。doctor を使用して、実際のディスク上の状態を検査してください。

macOSに関する注意（Apple Silicon）。 新しくビルドまたはコピーしたバイナリは、OSのバイナリポリシーにより、初回実行時にSIGKILLされます（Killed: 9、他の出力なし） — クォータニン属性がない場合でも同様です。一行インストーラーおよび bootstrap.sh ソースからビルドするインストーラーは、Perseus Vault をアドホックコード署名してくれます。自分でバイナリをビルドする場合は、ビルドのたびに一度署名してください：

cargo build --release
cp target/release/perseus-vault ~/.local/bin/perseus-vault
codesign --force --sign - ~/.local/bin/perseus-vault   # required on Apple Silicon; fixes "Killed: 9"

--force は既に署名されたバイナリに再署名します（ビルドのたびに必要）；この手順はIntel macOSでは無害であり、Linux/Windowsでは不要です。

次に、MCPクライアントと、完全な想起/キャプチャループを1つのコマンドで接続します：

perseus-vault install-client --hooks --rules

これはClaude Code / Codex / Cursorを自動検出し（--client <name> でclaude-desktop, hermes, windsurf, vscode, zed, genericを指定可能； --all-detected で検出したすべてのクライアントを接続）、MCPサーバー登録をクライアントの設定にマージします（何も上書きせず、先に .bak-perseus バックアップを作成）、すべてのクライアントを1つの共有メモリデータベースに向け、セッションライフサイクルフック（SessionStartでの想起インジェクション、セッション終了時の衛生管理 — docs/lifecycle-hooks.md 契約を参照）を登録し、メモリ使用ルールを CLAUDE.md/AGENTS.md に追加します。再実行は何も変更しません； --dry-run を追加して、触れるすべてのファイルをプレビューできます。

または、任意のMCPホストに手動で接続します（Claude Desktop, Cursor, Hermes Agent, Perseusなど）：

{
  "mcpServers": {
    "perseus-vault": {
      "command": "perseus-vault",
      "args": ["serve", "--db", "~/.perseus-vault/data/perseus-vault.db"]
    }
  }
}

Related MCP server: GroundMemory

エージェント向け：MCP経由で接続

主要なコンシューマーがエージェントである場合、インターフェースはMCPです — エージェントはMCPクライアントを介してVaultを採用し、サーバー自体を実行する以外に、マシンごとのCLIインストールは必要ありません：

# 1. Run the server (one line)
perseus-vault serve --db ~/.perseus-vault/data/perseus-vault.db &

# 2. Register it in the agent's MCP client config
#    { "mcpServers": { "perseus-vault": {
#        "command": "perseus-vault",
#        "args": ["serve", "--db", "~/.perseus-vault/data/perseus-vault.db"] } } }

# 3. Verify the agent-facing surface
perseus-vault doctor

perseus-vault install-client --hooks --rules は、Claude Code / Codex / Cursor / Hermes 向けの想起/キャプチャループ全体を1つのコマンドで接続します。エージェント向け機能マップ — どのツールがどの役割を担い、計画境界パターンを — については、docs/integration/agent-adoption.md を参照してください。

30秒クイックスタート

# Start Perseus Vault
perseus-vault serve --db memory.db &
sleep 1

# Remember a fact (via MCP JSON-RPC on stdio)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"perseus_vault_remember","arguments":{"category":"demo","key":"hello","body_json":"{\"text\":\"Hello from Perseus Vault!\"}"}}}' | perseus-vault serve --db memory.db

# Search for it
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"perseus_vault_recall","arguments":{"query":"Hello"}}}' | perseus-vault serve --db memory.db

メモリモデルと運用上の境界

Perseus Vault は3つのプレーンを明確に区別します：

• 暗黙的な作業コンテキスト は、ホストの現在のプロンプト、トランスクリプト、およびクライアントが注入することを選択した任意のコンテキストブロックです。これは一時的であり、ホストが所有します；Vaultがそれを返したという理由だけで永続化されるわけではありません。

• 明示的な永続メモリ は、明示的な perseus_vault_remember、perseus_vault_capture、write、または capture 操作によって書き込まれます。Vaultサーバーは、SQLiteレコード、履歴、ジャーナル、減衰、アーカイブ、パージのライフサイクルを所有します。

• 派生プロジェクション には、統合または合成されたレコードやエクスポートされたMarkdownが含まれます。これらは来歴を持ちますが、永続的なソースレコードの代替ではなく、個別のクリーンアップが必要になる場合があります。

perseus-vault prepare と perseus_vault_context は永続レコードを読み取り、境界がありタスクに関連するアクティブな作業コンテキストを生成します。これはローリングスナップショットであり、バックグラウンド書き込みや、クライアントがそれを保持するという約束ではありません：タスクが変わったら更新し、明示的なキャプチャ/書き込み操作が成功しない限り、プロンプトテキストを永続メモリとして扱わないでください。想起ファーストの出力は予算化されています（デフォルト1500文字、大ウィンドウホストでは6000文字、または明示的な max_context_chars）。always_on セットは最大5つに制限されています。保持とコンテキストのセマンティクス を参照してください。

ライフサイクルフックとクライアントインストーラーはオプションのオーケストレーションです。これらはサーバーが所有する想起、キャプチャ、メンテナンス、リフレッシュ作業を要求します；これらが2番目のストアになったり、保持ポリシーを変更したりすることはありません。サーバーまたはフックが利用できない場合は、注入されたメモリなしでタスクを続行し、機能低下状態を表面化してください。ホスト統合には明示的に構成されたローカルフォールバックがある場合がありますが、そのフォールバックはローカルのみとラベル付けされ、永続的なVaultの想起として提示されてはなりません；失敗した明示的な書き込みが永続化されたと報告されてはなりません。アップグレード/リカバリ手順については、アップグレードと移行プレイブック を使用してください。

すべてのMCPクライアントで動作

Perseus Vault は標準のMCP stdio サーバーです — 同じ perseus-vault serve コマンドがどこでも動作します。perseus-vault doctor を実行してインストールを検証し、このマトリックスをローカルに出力します。

各クライアントのコピーペースト用設定スニペット： docs/clients/。

次に、想起 → 作業 → キャプチャ → 統合 ループをクライアントのセッションイベントに接続します（Claude Code、Codex、Cursor向けのSessionStart/Stopフック、およびポータブルなAGENTS.mdフォールバック）： docs/lifecycle-hooks.md。

メモリワッシャー（CoalWash）とランタイム出力コンパクター（Noisegate）と組み合わせて、エンドツーエンドのコンテキスト予算制御を行う方法： docs/integration/context-budget-stack.md。

Vaultが何を、どこから、どの権限で記憶しているかを監査する方法： docs/evidence-chain-guidance.md — エビデンスチェーン、書き込み時の来歴タグ、永続メモリの継続的アテステーション。

メモリバンク（クライアントごとの分離、単一プロファイル）

同じプレイブックで50のクライアントを運用していますか？プロファイルを複製しないでください — プロジェクトごとにメモリバンクを指定し、1つのHermesプロファイル、1つのVault、1つの共有スキルライブラリを維持します：

# .hermes.md
memory_bank: acme-seo            # name → deterministic workspace hash
memory_bank_workspace: <64-hex>  # optional explicit workspace override

Hermesメモリプロバイダー （hermes plugins install Perseus-Computing-LLC/hermes-plugin-perseus-vault） は、バンクをセッションごとに1回解決し、すべてのVaultの読み取りと書き込み（プリフェッチ想起、perseus_recall / perseus_remember / perseus_forget、セッション終了時のキャプチャ）を専用のワークスペースに範囲付けます。バンク名は決定論的にマッピングされるため（sha256("memory-bank:" + name)）、同じ名前を指すすべてのインスタンスは、維持するレジストリなしで同じワークスペースをアドレス指定します。ワークスペースはサーバー上で第一級の存在です：範囲指定されたメンテナンス、バンク間の重複排除分離、ワークスペースごとの権限マニフェスト。ディスカバリはHermesプロジェクトコンテキストルールを反映します（最も近い .hermes.md が優先され、gitルートで境界が設定されます）；ディレクティブのないコンテキストファイルはバンクなしを意味します — 構成されたワークスペースが引き続き有効です。

Perseus Vault を選ぶ理由

Perseus Vault は、MCPネイティブ、ローカルファースト、ゼロ依存、かつエージェントファーストを同時に満たす唯一のメモリエンジンです。

LongMemEval QA（公式ハーネス）

自前のスクリプトではなく、LongMemEvalの公式ハーネスで測定された想起品質：

longmemeval_s（500問）、gpt-4o-2024-08-06回答者 + LongMemEval公式判定者；競合他社の数値は公開値です。Perseus Vaultの73.8%は3回の実行の単純平均；公式CoTでは79.0%。方法論とコンテンツハッシュ（sha256）結果 →

LOCOMO（mem0自身のハーネス）

私たちのものではなく、mem0自身のLOCOMOハーネス（私たちのフォーク）で測定 — カテゴリ1～4、1,540問、top-200、gpt-5回答者 + 判定者：

カテゴリ5 敵対的（446問）：Perseus 63.5、Mem0 55.6、Zep 49.8。私たちのMem0測定値は、公開ファイルより9.4ポイント低いです（判定者/プラットフォームのドリフト — 開示済み）。完全なリーダーボード →

二時点タイムトラベル（三軸）

私たちの最も強力な構造的差別化要因 — 完全なSQL:2011 二時点履歴 （トランザクション時間 および 有効時間） — 再現可能で完全にオフラインのガントレットに対して測定。実際に出荷されるバイナリをMCP stdio経由で駆動し、単軸の競合他社が誤る難しいケース（遡及的修正、先行的な未来日付の事実、順序不同の到着、信念と真実の乖離、閉じられた期間）を処理します：

1つのコマンドで再現（APIキー不要、ネットワーク不要、LLM不要）：

cargo build --release
python benchmark/temporal/gauntlet.py --bin target/release/perseus-vault

PASS/FAILの判定は決定論的です（ウォールクロックのタイムスタンプは変動しますが、判定は変動しません）。そのため、正しいビルドを再実行すると同一のsignature_sha256になります。コミットされたgauntlet_report.jsonがリファレンスです。方法論とデータセット →

比較マトリクス

完全比較: Perseus Vault vs Mem0 → vs Letta → vs Zep →

ストレステスト: 100Kエンティティ

Perseus Vaultは控えめなハードウェアでも本番ワークロードを処理します。以下の数値はコミットされた成果物benchmark/scale/report.jsonからのものです。実際のリリースバイナリをMCP stdioで駆動（コーパスサイズごとに1つの永続プロセス）、AMD64 16コア、Windows 11、各書き込みは次の書き込みが送信される前に永続化されます。

完全なパーセンタイル、as_ofポイントルックアップ、テンポラル再現率、コールドスタートの数値はbenchmark/scale/にあります。

自分で実行：python benchmark/scale/run.py

スケールでの再現率精度: キーワードは崩壊、ハイブリッドは維持

速度は当然の前提です。エージェントメモリにとって重要な質問は正しいメモリが実際に表面化するのか？ ということです。異なる内容のコーパス（ファーストパーティ、再現可能；benchmark/lambda/参照）で測定された、モード別のrecall@k：

100,000エンティティ（1×H100、nomic-embed-text on Ollama）：

100Kエンティティでは、ハイブリッド再現率は**@5で完全であり、キーワード検索は約1.5%の時間しかヒットしない** — 約66倍の差。そしてそれはスケールに応じて拡大します：10Kエンティティではキーワードrecall@5は0.008でしたが、ハイブリッドはすでに1.000でした。キーワードのみのメモリはエージェントが履歴を蓄積するにつれて静かに劣化しますが、ハイブリッド（BM25 + デンス + 相互ランク融合）は劣化しません。これがPerseus Vaultのハイブリッド検索の核となる主張です。

直接対決、同一マシン、同一コーパス、すべて完全ローカル（1×H100、Ollama — 全システムで同一の事実セット、クエリ、および部分文字列判定器）：

すべての競合他社は、同一マシンで立ち上げられ、実行され、同一のローカルOllama（qwen2.5:14b-instruct + nomic-embed-text）に対して — クラウドなし、捏造数値なし。Lettaはletta/lettaサーバー（バンドルされたPostgres/pgvector）として実行され、Perseus Vaultと1.00で一致しました。ZepのセルフホストCommunity Editionサーバーは非推奨であり、そのzep_pythonメモリAPIは現在Zep Cloud専用であるため、Zepの実際のOSSエンジン — Neo4j上のGraphitiテンポラルKG — を、エンティティ/エッジ抽出と埋め込みを同一のローカルOllamaで測定しました。その0.20は、ローカルモデルでナレッジグラフを構築する正直なコストを反映しています（構造化抽出はロスが多い：6つの事実から5エンティティ/2エッジ） — フロンティアモデルを使用するZep Cloudではありません。完全な成果物+方法論：benchmark/lambda/results/competitors.json。

コールドスタート： ベアGPUボックスは最初のgrounded RAG回答を3.3秒で到達します（モデルはディスク上にステージング）。

再現：benchmark/lambda/scale_bench.py および competitors_bench.py。

GPUホスト上のモデルサーバー（vLLM on MI300X/H100）の隣にデプロイする？AMD MI300Xデプロイメントリファレンスを参照 — 測定された共存数値と、/dev/shm、PID-1、バージョン固定の落とし穴（これらが実際にこれらのスタックを壊す）を含みます。

フレームワーク統合

Perseus Vaultを人気のあるAIエージェントフレームワークのデフォルトメモリバックエンドにする即使用可能なアダプター：

各アダプター：

• MCP stdioサブプロセスを介して接続（永続セッション）

• フレームワークのメモリインターフェースをPerseus Vaultツールにマッピング

• READMEクイックスタート付き（5分で動作開始）

• モックされたMCPトランスポートで合格するテストあり

MCP互換のフレームワークはすべてPerseus Vaultと直接動作します。完全なリストはMCPクライアントとフレームワーク統合を参照してください。

150の正規MCPツール

正規の製品名とツール名。 Perseus Vaultは製品名であり、統合は正規のperseus_vault_*ツール（例：perseus_vault_remember）を使用します。レガシーのmimir_* / mneme_* / plutus_*名は2026-27メジャーリリースで削除されました — 正規名が唯一のインターフェースです。 カウントはソースレジストリ内の一意の正規ツールの数です。互換性エイリアスは呼び出し可能ですが、個別にカウントされません。 レガシーのperseus_vault_*およびperseus_vault_*名は完全に呼び出し可能のままです — すべてのプレフィックスは同じハンドラーにディスパッチします — ただし、tools/listでアドバタイズされなくなっただけです。これにより、アドバタイズされるマニフェストはツールごとに1つの名前に保たれ、3倍（3倍のエイリアス膨張）にならないため、接続されたクライアントはリクエストごとに3倍のツールスキーマペイロードをリロードしません。3つすべてのプレフィックスをアドバタイズする過去の動作を復元するには、PERSEUS_VAULT_TOOL_ALIASES=allを設定します（レガシー環境変数PERSEUS_VAULT_TOOL_ALIASESも尊重されます；PERSEUS_VAULT_が優先されます）。

クライアント互換性（#633）。 アドバタイズされたリストにゲートをかけるクライアント — つまり、呼び出し前にtools/listをチェックし、見えないツールをスキップする — は、呼び出し自体は成功するにもかかわらず、2.xボールトに対するレガシーのperseus_vault_*呼び出しを静かにスキップします。既知のケース：perseus CLI ≤ 1.0.22 はperseus_vault_recallをハードコードし、空のローカルのみの再現に劣化します。どちらかの側で修正：CLIを**≥ 1.0.23**にアップグレードする（動的フォールバックで正規名を呼び出す）、または、古いクライアントがまだデプロイされている間のブリッジとして、ボールトにPERSEUS_VAULT_TOOL_ALIASES=allを設定する。

ツールスコープ（広告階層、#1051）

デフォルトでは、tools/listはすべての正規ツールをアドバタイズします。PERSEUS_VAULT_TOOL_SCOPEを設定して、トークンと注意に制約のあるエージェントクライアント向けにアドバタイズ範囲を狭めます：

スコープはアドバタイズのみです：隠されたツールはtools/callを介して完全に呼び出し可能であり、認可はワークスペースバインディングと権限マニフェストに残ります。階層分類は1:1のサイドテーブル（src/mcp.rsのTOOL_SCOPES）であり、scripts/registry_metadata_check.pyによってCIで強制されます — 新しいツールはすべて分類されなければなりません。admin階層のツール（migrate、purge、erase、vault_import、authority_set / authority_revoke / authority_set_signed）はスコープ付きリストに決して表示されません。

エンティティCRUD

検索 & RAG

📖 docs/retrieval-modes.md — すべての検索モード（キーワード · 密 · ハイブリッド · グラフ · GraphRAG · プロアクティブ recall_when · 時間的 as_of）の列挙されたリファレンス: メカニズム、使用タイミング、呼び出し、および例。

ジャーナル

状態

ライフサイクル

品質

キーストーン（ポリシールール）

金庫とフェデレーション

メトリクスと運用

ジョブ別ツール（エージェントチートシート）

カテゴリ一覧ではありません。ジョブ一覧です。エージェントが実行しようとしている内容に該当する行を選んでください：

CLI

# Server
perseus-vault serve --db /data/perseus-vault.db
perseus-vault serve --web --port 8767 --encryption-key ~/.perseus-vault/secret.key
perseus-vault serve --llm-endpoint http://localhost:11434/api/generate --llm-model llama3
perseus-vault serve --transport sse --port 8787 --mcp-token my-secret-token

# Maintenance (operate directly on DB, no server needed)
perseus-vault stats          --db /data/perseus-vault.db
perseus-vault forget         --db /data/perseus-vault.db --category decision --key stale-choice --reason "superseded"
perseus-vault prune          --db /data/perseus-vault.db --category junk --min-decay 0.1 --dry-run
perseus-vault purge          --db /data/perseus-vault.db --dry-run
perseus-vault decay          --db /data/perseus-vault.db
perseus-vault reindex        --db /data/perseus-vault.db
perseus-vault vault-export   --db /data/perseus-vault.db --vault-dir ./export/
perseus-vault vault-import   --db /data/perseus-vault.db --vault-dir ./export/
perseus-vault obsidian-sync  ~/obsidian-vault/Perseus Vault/          # one-shot export to an Obsidian vault
perseus-vault obsidian-sync  ~/obsidian-vault/Perseus Vault/ --watch  # continuous sync on every memory change

# Key management
perseus-vault keygen --key-file ~/.perseus-vault/secret.key

# #918: read-only TUI inspector (retrieval telemetry, claim cards, entity
# state, decay, bi-temporal history). Never writes; repairs go through the
# governed MCP tools. Requires the default `tui` feature.
perseus-vault inspect --db /data/perseus-vault.db --key-file ~/.perseus-vault/secret.key

セッションを再起動せずにライブ更新

perseus-vault serve は、自身のバイナリがセッション中にディスク上で置き換えられた（通常の cargo build / 再インストールの流れ）ことを検出し、古いプロセスイメージからの結果提供を拒否します — すべてのツールは空の結果に劣化する代わりに、明示的なエラーメッセージを返します（#858、#1045）。同じ stdio 接続上で2つの復旧パスがあります（クライアントの再起動は不要）：

• 明示的： perseus_vault_handoff_restart {"confirm": true} を呼び出すと、プロセスが新しいバイナリにホットスワップされ、MCPセッション状態（初期化 + エージェントID）を保持したままセッションが継続します。

• 自動（オプトイン）： PERSEUS_VAULT_AUTO_HANDOFF=1 を設定してサーバーを起動すると、次のツール呼び出し時に透過的にスワップが行われ、新しいバイナリが直接応答します。

macOS/Linuxでは、スワップは真の exec（同じPID、同じパイプ）です。Windowsでは実行中の実行ファイルがロックされるため、セッション途中での置き換えは不可能です。セッション境界をまたいで更新を行ってください。完全な契約とローカル開発ワークフローは docs/specs/live-update-handoff.md を参照してください。

手動DB編集。 上記のメンテナンス動詞と通常のMCP書き込みパスは、FTS5インデックスを自動的に同期します。entities テーブルを sqlite3 で直接編集する（手動の DELETE/UPDATE）と、その同期をバイパスし、孤立したインデックス行が残る可能性があります — すでに存在しないコンテンツに対する「ゴースト」再現ヒットです。直接SQL編集を行った後は、perseus-vault maintain --db <path>（または perseus-vault reindex）を実行してFTSインデックスを調整してください。

フラグ

データベースの場所

正規のデータベースパスは：

~/.perseus-vault/data/perseus-vault.db

スクリプト、MCPホスト設定、cron/ハーベストジョブでは常に --db を渡す（または $PERSEUS_VAULT_DB_PATH を設定する）ことで、すべての呼び出しが同じファイルを対象にします。どちらも設定されていない場合、Perseus Vault は以下の順序でデフォルトを解決し、既に存在する最初のものを使用します（そのため、アップグレードユーザーや従来のシングルユーザーインストールが空の状態でサイレントに起動されるのではなく、検出されます）：

1. ~/.perseus-vault/data/perseus-vault.db — 正規（現在の名前）

2. ~/.perseus-vault/data/perseus-vault.db — 名前変更前

3. ~/.perseus-vault/data/perseus-vault.db — 名前変更前

4. ~/perseus-vault.db — 従来のシングルユーザーインストール場所

いずれも存在しない場合は、~/.perseus-vault/data/perseus-vault.db を作成します。これらのうち複数が存在し、かつ --db/$PERSEUS_VAULT_DB_PATH を渡していない場合、Perseus Vault は選択したファイルと無視した他のファイルをstderrに警告として出力するため、あいまいなマルチデータベース状態がサイレントではなく表示されます。--db または $PERSEUS_VAULT_DB_PATH を明示的に設定すると常に優先され、警告は抑制されます。

Obsidian でのAIメモリ

Perseus Vault はAIエージェントの長期記憶であり、同時にあなたの第二の脳としても機能します。エージェントが記憶したすべてのエンティティは、YAMLフロントマター付きのプレーンなMarkdownノートとしてエクスポートされるため、AIの記憶は、すでに使用しているObsidian、Logseq、Notionなどのツール内でナビゲート可能なパーソナルナレッジベースになります。

# Export your entire memory to an Obsidian vault as linked Markdown notes
perseus-vault obsidian-sync ~/obsidian-vault/Perseus Vault/

# Keep it live — re-export automatically on every memory change
perseus-vault obsidian-sync ~/obsidian-vault/Perseus Vault/ --watch

ボールトをObsidianで開くと、エージェントの知識のグラフが表示されます。

WikiLinkバックリンク。 あるエンティティが別のエンティティにリンクしている場合（perseus_vault_link または depends_on / implements / references 関係を介して）、エクスポートされたノートには ## Links セクションが追加され、[[WikiLink]] バックリンクがObsidianのグラフビューでネイティブに解決されます：

---
id: cli-de8dfb8364b6
category: architecture
key: api
type: insight
decay_score: 0.5000
---

{"content":"axum service"}

## Links

- [[cli-99756b494c7d|database]] (depends_on)

リンクはエンティティIDで解決されます（ノートは <id>.md として書き込まれる）ため、壊れることはなく、Obsidianはリンクラベルとして人間が読める key を表示します。グラフビューを開けば、エージェントのアーキテクチャ、決定、洞察がクリック可能なナレッジマップになります。

--watch は、安価で決定論的な状態ダイジェストを一定間隔でポーリングし、メモリが実際に変更された場合にのみ再エクスポートします。ファイルシステム監視の依存関係やサーバーとの結合なしに、すべての perseus_vault_remember 書き込みを自然にキャッチします。間隔は PERSEUS_VAULT_SYNC_INTERVAL_SECS で調整できます（デフォルト：2秒）。

その他のPKMツール

クラウド専用の「第二の脳」ツールとは異なり、Perseus Vault は100%ローカルで動作し、Rust で書かれ、AES-256-GCM で保存時に暗号化し、減衰スコアリングを適用して古い記憶を薄れさせます — 知識ベースはあなたのものであり、新鮮さを保ちます。

機能

セマンティック検索（デフォルトでオン）

• バンドル済みインプロセス埋め込み — 量子化された all-MiniLM-L6-v2 モデル（384次元）がバイナリにコンパイルされているため、密ベクトル／意味検索は設定不要かつネットワーク不要で動作します：Ollama、APIキー、モデルのダウンロードは一切不要です。これがデフォルトのビルド（bundled-embeddings フィーチャー）です。

• 書き込み時の自動埋め込み（#271） — perseus_vault_remember は、新しい（または内容が変更された）エンティティを書き込み時に同期的に埋め込み、バンドルモデルを使用します。単一エンティティの埋め込みは決定論的でLRUキャッシュされるため、処理は軽量でバックグラウンドタスクは追加されません。埋め込みの失敗は致命的ではありません（stderrにログ出力）；書き込みは常に成功します。

• ハイブリッドがデフォルトの検索モード（#271） — mode フラグなしの perseus_vault_recall(query=...) は、埋め込みが存在する場合は自動的にハイブリッド（RRFで融合された密ベクトル＋キーワード）を選択し、埋め込みがない場合は透過的に fts5 キーワード検索にフォールバックします。手動の perseus_vault_embed ステップや覚えるべきフラグは不要です。

• perseus_vault_semantic_search(query, limit) — 「これに似たものを見つける」だけを行いたい場合の、純粋な密ベクトルベースの意味検索（キーワードフォールバックなし）のためのワンツールショートカット。

• オプションの代替埋め込みエンジン — バンドルモデルの代わりにOllamaまたはOpenAI互換の /v1/embeddings エンドポイントを使用するには、--llm-endpoint（および必要に応じて --embedding-endpoint / --llm-api-key）を設定します。これは完全にオプションです；デフォルトではバンドルモデルが使用されます。

• cargo build --no-default-features でバンドル埋め込みなしの軽量バイナリをビルド — その場合、リモート埋め込みエンジンが設定されていない限り、検索はデフォルトでキーワード検索になります。

ハイブリッド検索の内部

• FTS5キーワード検索 — LIKEフォールバックとPorterステミング展開を備える

• 密ベクトル検索 — 保存された埋め込みに対するコサイン類似度による

• 相互ランク融合（RRF） — キーワードとベクトルの結果を結合

• クエリ拡張 — より広範な検索のための自動ステミングバリアント

メモリライフサイクル

Perseus Vaultは、人間の記憶経路に着想を得た3つの生体模倣層を使用してメモリをモデル化します：

• 世界（コア） — 減衰が遅い、環境に関するグローバルな事実。

• エピソード（バッファ） — 減衰が速い、セッション固有の対話履歴。

• 意味（ワーキング） — 減衰が中程度の、一般的な知識と学習された概念。

これらの層とは、perseus_vault_recall_layer ツールを使用するか、perseus_vault_remember で layer パラメータを指定することで直接対話できます。

• エビングハウスの忘却曲線 — 記憶は取得されない限り自然に薄れます（アクセス時にリフレッシュ）

• 層の昇格 — アクセス頻度に基づいてバッファ → ワーキング → コアへ昇格

• 自動アーカイブ — 古いエンティティはアーカイブ；パージで完全に削除＋VACUUM

• 常時オンエンティティ — セッションインジェクションのためにアイデンティティに重要なメモリを固定（検索ファーストではハードキャップあり；recall_when トリガーを推奨）

• プロスペクティブクエリヒント（#919） — エンティティごとにオプションで1～3の自然言語フレーズ（perseus_vault_remember の hints）を本文とともにFTS5にインデックス化し、平易なクエリと保存された表現の間の語彙ギャップを埋めます。デフォルトではオフ（PERSEUS_VAULT_HINTS_ENABLED=1）；無効時は拒否されます。詳細は docs/specs/prospective-query-hints.md を参照。

検索ファーストコンテキストインジェクション

Vaultはクエリ層です — ターンに必要な少数の事実を取得し、ホストにすべてのシステムプロンプトに貼り付けるための固定ブロブを渡すことはしません。 perseus_vault_context と perseus-vault prepare はデフォルトで検索ファーストです：

• 関連性ゲーティング — query（現在のタスク/メッセージ）を渡すと、その recall_when トリガーまたはインデックス化されたコンテンツが一致するエンティティのみが注入されます。クエリがない場合、トピックに基づく注入は行われません：ブロックはコンパクトな検索ポインタとなり、無関係なVault書き込み間でバイト安定（プレフィックスキャッシュに優しい）。

• モデルごとの検索予算 — 出力はホストモデルから解決された文字数予算に制限されます：デフォルト/リーンプロファイルは1500文字；大ウィンドウ（「opus」）プロファイルは6000文字；max_context_chars は両方を上書きします。

• 上限付き常時オン — always_on: true はアイデンティティに重要な事実に対して引き続き機能しますが、検索ファーストセットはハードキャップ（上位5件）され、オーバーフロー時には recall_when トリガーを促す警告が出力されます。

• レガシーオプトイン — 古い無条件のトップNダンプは、mode: "always_inject"（prepare の場合は --legacy-context）で引き続き利用可能で、予算を渡さない限り制限はありません。

perseus-vault prepare --task "deploying the payments service" --model claude-sonnet-4-6
perseus-vault prepare --task "..." --max-context-chars 800     # explicit budget
perseus-vault prepare --task "..." --legacy-context            # old dump, opt-in

RAGと埋め込み

• perseus_vault_ask — 任意のLLM（Ollama、OpenAIなど）を介した、保存されたメモリに対する自然言語Q&A

• perseus_vault_embed — OllamaまたはOpenAI互換の /v1/embeddings を介した密ベクトルの生成と保存

• 単一エンティティおよびバッチカテゴリの埋め込みをサポート

暗号化

• AES-256-GCM によるエンティティ body_json の透過的暗号化

• 新規インストールではデフォルトで有効 — 標準キーは最初の書き込み時に ~/.perseus-vault/secret.key に自動生成されます

• 明示的なキーには --encryption-key フラグ；カスタムキー生成には perseus-vault keygen

• 既存の平文データベースは、init --rekey 移行パス（または明示的な PERSEUS_VAULT_ALLOW_PLAINTEXT=1）でクローズドに失敗します

• FTS5インデックスは検索のために平文のままです

Webダッシュボード

• 組み込みのAxum HTTPサーバー（perseus-vault serve --web --port 8767）

• ダークテーマのダッシュボード：検索、エンティティテーブル、vis.jsグラフ、タイムライン

• デフォルトのバインド：127.0.0.1（公開するには --web-bind 0.0.0.0 を使用）

• 同時読み取りのためのWALモードの個別SQLite接続

外部コネクタ

• GitHub issuesコネクタ — リポジトリごとにIssue/PRを取り込み、レート制限対応

• ファイルウォッチャー — コンテンツハッシュによる重複排除で .md/.txt/.json ファイルのディレクトリをスキャン

• YAMLベースのコネクタ設定（--connectors-config 経由）

マルチトランスポート

• stdio（デフォルト） — 設定不要、任意のMCPホストで動作

• SSE — HTTPベースのMCPクライアント向けサーバー送信イベント

• HTTP — REST形式のMCPエンドポイント

• Bearerトークン認証 — SSE/HTTPトランスポート用

Perseus統合

Perseus Vaultは、Perseus のデフォルトメモリバックエンドです：

perseus_vault:
  enabled: true
  transport: "stdio"
  command: ["perseus-vault", "serve", "--db", "~/.perseus-vault/data/perseus-vault.db"]
  timeout_s: 30.0
  merge_strategy: "local_first"
  fallback_to_local: true
  context_categories: ["decision", "architecture", "convention"]
  context_limit: 10

政府および連邦調達

Perseus Vaultは、政府での展開を前提にゼロから構築されています。

連邦政府の購入者向け： 調達情報、コンプライアンスステータス、展開モデル（エアギャップ、オンプレミス、機密環境）については docs/federal-buyers.md を参照してください。

Perseus Computing LLCは米国所有の小規模企業です。SAM.gov登録進行中。 NAICS: 541715, 541511, 541512。

プライバシーポリシー

Perseus VaultはローカルファーストのMCPサーバーです — 完全にあなたのマシン上で動作します。

データ収集

• データ収集は行いません。 Perseus Vaultは、ユーザーデータ、使用統計、テレメトリを収集、送信、またはホームコールすることはありません。

• すべてのデータはローカルのSQLiteデータベースファイルに残ります。

データの使用と保存

• すべてのメモリエンティティ、ジャーナルエントリ、状態は、--db で指定したパスのローカルSQLiteデータベースに保存されます。

• オプションの保存時のAES-256-GCM暗号化が利用可能です — 有効にすると、エンティティのボディは保存前に暗号化されます。

• Perseus Computing LLCまたは第三者とデータが共有されることはありません。

第三者との共有

• なし。 Perseus Vaultはデフォルトで完全にエアギャップされています。APIコール、クラウドサービス、外部ネットワークリクエストはありません。

• オプションの密ベクトル埋め込み機能は、ローカルでコンパイルされたモデルを使用します — 外部の埋め込みAPIは呼び出されません。

データ保持

• 4つの異なるライフサイクル操作で保持を制御します（詳細は docs/specs/data-boundaries-retention-lifecycle.md を参照）：ソフトデリート（perseus_vault_forget、コンテンツは復元可能）、期限切れ（perseus_vault_expire、時間ベースの status='expired'、コンテンツは保持）、編集（perseus_vault_redact、コンテンツはハッシュのみにスクラブ、メタデータは保持）、物理的消去（perseus_vault_erase、すべての派生層から削除、永続的な再取り込み抑制）。perseus_vault_purge はアーカイブされた行からスペースを再利用します。

• 自動的なマシン外へのバックアップは実行されません。

連絡先

• メール： privacy@perseus.observer

• GitHub： Perseus-Computing-LLC/perseus-vault

リリース検証

リリースバイナリは、GitHub Actions を介してタグ付けされたコミットからビルドされます。すべてのリリースには以下が含まれます：

リリースバイナリの検証

# 1. Verify SHA-256 checksum
sha256sum -c perseus-vault-lite-x86_64-unknown-linux-musl.tar.gz.sha256

# 2. Verify SLSA build provenance (requires gh CLI + OIDC session)
gh attestation verify perseus-vault-lite-x86_64-unknown-linux-musl.tar.gz \
  --repo Perseus-Computing-LLC/perseus-vault

# 3. Confirm the binary identity
./perseus-vault --version
# Should show both the release version AND the git commit hash, e.g.:
#   perseus-vault 2.20.2 (v2.20.2-0-gabcdef1)

# 4. Confirm the doctor reports the same identity
./perseus-vault doctor --db /tmp/test.db | head -1
#   perseus-vault doctor — v2.20.2 (v2.20.2-0-gabcdef1)

ソースからの再現可能なビルド

# The exact same binary (bit-for-bit) requires matching:
#   - Rust toolchain version (see rust-toolchain.toml)
#   - Locked dependencies: `cargo build --locked`
#   - Build flags: `--release` for release builds

cargo build --locked --release
./target/release/perseus-vault --version

ライセンス

MIT — LICENSE を参照。