Codex Vault

Codex Vault は Codex デスクトップアプリのローカルプラグインで、Obsidian 互換の Markdown vault を読み取り、ノートを検索し、backlinks とナレッジグラフを表示し、選択したコンテンツをチャットコンテキストに追加できます。

[!IMPORTANT] プロジェクトはまだ初期開発段階で、現在は personal marketplace を通じてのみテストされており、まだ公開リリースされていません。

機能

• Markdown、wikilinks、tags、frontmatter の閲覧と検索。

• backlinks、孤立ノート、壊れたリンク、ナレッジグラフの表示。

• テキストを選択してコメントを追加し、Codex composer に添付します。自動送信はされません。

• 複数のコメントを蓄積でき、各コメントにはノートのパス、テキスト、行番号が保持されます。

• MCP tools を通じてノートを安全に読み書きします。書き込みはデフォルトで無効です。

Related MCP server: vault-master-mcp

使用

インストール後、新しい Codex task を作成し、@Codex Vault を選択して、「Vault Explorer を開く」と入力します。プラグインを更新した後も新しい task を使用する必要があります。既存の task では MCP tools はホットリロードされません。

コメントを追加：

1. Markdown reader でテキストを選択し、「チャットに追加」を押します。

2. 必要に応じてコメントを入力し、再度「チャットに追加」を押します。

3. composer に戻って質問を入力すると、送信時にコメントとともにモデルに渡されます。

コメントはチャットコンテキストにのみ存在し、Markdown に書き戻されることはありません。

能力の境界

• これは Codex plugin と MCP App であり、Codex App の fork ではありません。

• Codex のプライベート UI の固定サイドバーやモデル選択メニューとしてインストールすることはできません。

• コメントは公開の updateModelContext() を使用しており、Codex のプライベートなコメントデータモデルではありません。

• 現在は主に macOS で検証されています。他のプラットフォームではまだ完全にはテストされていません。

開発

要件：Node.js 22+、Yarn Classic 1.x、および Plugins/MCP Apps をサポートする Codex App。

git clone https://github.com/Avery320/codex-vault.git
cd codex-vault
yarn install
yarn build
yarn workspace @foam/mcp test
yarn workspace @foam/graph-view test:unit

personal marketplace が設定されている環境では、以下を実行できます：

codex plugin add codex-vault@personal
codex plugin list

./scripts/launch_codex_vault_mcp を直接実行すると stdio server のみが起動し、Codex UI は表示されません。完全な更新手順は開発ガイドを参照してください。

書き込み

CODEX_VAULT_ALLOW_WRITES=true を設定するか、~/.config/codex-vault/allow-writes の内容を true にすると、書き込み tools が有効になります。

既存のノートを変更するには、まず preview_resource_update を呼び出し、返された SHA-256 を使用して update_resource を呼び出す必要があります。ファイルが変更されている場合は conflict が返され、新しい内容は上書きされません。

ドキュメント

• 使用ガイド

• アーキテクチャと能力の境界

• 開発ガイド

• セキュリティとローカルデータ

• Fork とライセンス

Fork とライセンス

Codex Vault は Foam から派生しており、その Markdown、wikilink、graph のコアを引き継ぎ、Codex plugin、MCP App、複数 vault 管理、チャットコメントを追加しています。

本プロジェクトは MIT License を採用しています。アップストリーム、Microsoft 由来のソース、およびサードパーティ依存関係の帰属については NOTICE.md を参照してください。Codex Vault は OpenAI、Obsidian、Foam の公式製品ではありません。