Context Vault

context-vault

AI エージェント向けの永続メモリーです。エージェントが学んだことを保存し、次のセッションで見つけられます。エントリーは、お使いのマシン上にあるプレーンな Markdown ファイルです。

ホステッドプラン：クラウド同期、ウェブダッシュボード、チーム共有は app.context-vault.com

クイックスタート：5分以内に新しいセッションでメモリーを呼び出す

Claude Code を使用したクリーンな macOS アカウントで計測しています。コマンドの実行に約1分、入力時間は別途かかります。

1. バイナリをインストールする（macOS と Linux。Node は不要です）：

curl -fsSL https://context-vault.com/install.sh | bash

context-vault が ~/.local/bin に配置されます。そのフォルダーが PATH に含まれていないと表示された場合は、出力された行を実行してから、新しいターミナルを開いてください。

2. AI ツールを接続する：

context-vault setup

Claude Code と検出されたその他すべてのクライアント（Claude Desktop、Cursor、Windsurf、Cline、Roo Code）の MCP 設定に Context Vault を追加します。--client claude-code を指定すると1つのクライアントに限定されます。--dry-run を指定すると、書き込まれる内容を確認できます。

3. AI ツールを再起動する。 終了して、もう一度起動してください（Claude Code の場合は、新しいターミナルで新しく claude を実行します）。初回起動時に検索モデル（約90 MB）が一度だけダウンロードされます。

4. 何かを保存する。 Vault に名前を付けてください。そうしないと、Claude Code が独自の組み込みメモリーに保存することがあります。

Vault に保存：ステージングバケットの名前は aurora-gravel-17 です

5. 新しいセッションで呼び出す。 終了して、新しいセッションを開始し、次のように尋ねます。

Vault を検索：ステージングバケットの名前は何ですか？

回答は Vault から取得され、エントリーは ~/.vault/ 内の Markdown ファイルに保存されています。ファイルは開いて編集できます。context-vault doctor を実行すると、engine health: OK と表示されるはずです。

Windows の場合：irm https://context-vault.com/install.ps1 | iex を実行して新しいターミナルを開き、手順2〜5を行ってください。

できること

• 保存：知見、決定事項、パターン、参考情報を保存します。作業中にエージェントが書き込みます。
• 検索：自然言語で、全文検索とセマンティック検索を組み合わせて検索します。
• データを自分で管理：自分で管理するフォルダー内の Markdown ファイルなので、Git と相性がよく、人が編集できます。

MCP ツール

エージェントが以下のツールを呼び出します。エージェントには普通の言葉で話しかけてください。

ツール	機能
save_context	エントリーを保存するか、ID を指定して更新します
get_context	Vault を検索します（全文検索とセマンティック検索）
recall	プロンプト、エラー、ファイルパスなど、未加工のシグナルから手がかりを得ます
list_context	種類、タグ、日付でエントリーを閲覧します
delete_context	ID を指定してエントリーを削除します
ingest_url	ページを取得し、読みやすいテキストを保存します
ingest_project	ローカルプロジェクトをスキャンして登録します
create_snapshot	トピックに関するエントリーを1つの概要にまとめます
session_end	セッションの概要と発見事項を保存します
context_status	Vault の状態を確認します：パス、件数、問題
list_buckets	バケットを一覧表示します（bucket:<name> タグでエントリーを絞り込みます）

種類（insight、decision、pattern、reference、または独自の種類）は、Vault 内のフォルダーです。

CLI

コマンド	説明
context-vault setup	MCP サーバーを AI ツールに登録します
context-vault doctor	インストール状況を確認します：パスとエンジンの状態
context-vault status	エントリー数と解決済みパスを表示します
context-vault search <q>	シェルから検索します
context-vault save	シェルからエントリーを保存します
context-vault reindex	Markdown ファイルからインデックスを再構築します
context-vault --help	すべてのコマンドを表示します

設定

設定	デフォルト	上書き
Vault	~/.vault/	CONTEXT_VAULT_VAULT_DIR
データ	~/.context-mcp/	CONTEXT_VAULT_DATA_DIR
データベース	~/.context-mcp/vault.db	CONTEXT_VAULT_DB_PATH

トラブルシューティング

• context-vault: command not found：インストール先フォルダーが PATH に含まれていません。~/.local/bin/context-vault setup を実行するか、インストーラーが表示した行をシェルのプロファイルに追加してください。
• エージェントが Vault ツールが見つからないと言う場合：セットアップ後に AI ツールを再起動してください。Claude Code では、/mcp で context-vault が接続されているか確認できます。context-vault setup --print で書き込まれるエントリーを確認できます。
• エージェントが別の場所に保存した場合：リクエストで「my vault」と伝えてください。
• 検索結果が古い場合：context-vault reindex を実行してください。

npm パッケージ（npx context-vault）は、引き続き古い 3.20 Node ビルドです。上記のインストールスクリプトを使用してください。

ホスト型オプション

app.context-vault.com でクラウド同期、ウェブダッシュボード、チーム共有を利用できます。Claude Code、Cursor、GPT Actions のセットアップ方法：docs/distribution/connect-in-2-minutes.md

フィードバック

• 質問やアイデアがありますか？ ディスカッション
• バグを見つけましたか？ Issue を作成

開発

git clone https://github.com/fellanH/context-vault.git
cd context-vault
cargo build --release -p context-vault-cli
./target/release/context-vault --help

ライセンス

MIT