Codex Vault

Codex Vault — это локальный плагин для настольного приложения Codex, который позволяет читать заметки в формате Markdown, совместимые с Obsidian, прямо в чате Codex. Он включает в себя MCP-сервер, который предоставляет инструменты для поиска, чтения и записи заметок, а также панель для визуализации графа заметок.

[!IMPORTANT] Проект находится на ранней стадии разработки и пока распространяется только через персональный маркетплейс, публичного релиза ещё не было.

Возможности

• Поиск и чтение Markdown-заметок, wikilinks, тегов и frontmatter.

• Отображение обратных ссылок, сиротских заметок, битых ссылок и графа знаний.

• Выделение текста и добавление его в чат Codex; ничего не отправляется автоматически.

• Накопление нескольких выделенных фрагментов с сохранением пути к заметке, текста и номера строки.

• Безопасное чтение и запись заметок через MCP-инструменты; запись по умолчанию отключена.

Related MCP server: vault-master-mcp

Использование

После установки создайте новую задачу Codex, выберите @Codex Vault и введите «Открыть обозреватель Vault». После обновления плагина необходимо создавать новую задачу, так как существующие задачи не перезагружают MCP-инструменты.

Добавление заметок в контекст:

1. Выделите текст в режиме чтения Markdown и нажмите «Добавить в чат».

2. При необходимости введите комментарий и снова нажмите «Добавить в чат».

3. Вернитесь в чат Codex и отправьте сообщение — выделенные фрагменты будут включены в контекст.

Заметки существуют только в контексте чата и не записываются обратно в Markdown.

Границы возможностей

• Это плагин Codex и MCP-приложение, а не форк самого Codex.

• Его нельзя установить как фиксированную боковую панель или использовать для управления моделями в интерфейсе Codex.

• Для передачи заметок используется публичный updateModelContext(), а не приватная модель данных заметок Codex.

• В настоящее время проверяется только на macOS; другие платформы пока не протестированы.

Разработка

Требования: Node.js 22+, Yarn Classic 1.x и настольное приложение Codex с поддержкой плагинов и MCP-приложений.

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

В среде с настроенным персональным маркетплейсом можно выполнить:

codex plugin add codex-vault@personal
codex plugin list

При прямом запуске ./scripts/launch_codex_vault_mcp будет запущен только stdio-сервер, без графического интерфейса Codex. Полный процесс обновления описан в руководстве для разработчиков.

Запись

Запись включается только при установке переменной окружения CODEX_VAULT_ALLOW_WRITES=true или при наличии файла ~/.config/codex-vault/allow-writes с содержимым true.

Перед изменением существующей заметки необходимо вызвать preview_resource_update, а затем отправить update_resource с SHA-256-хешем из ответа; если файл был изменён, будет возвращён conflict, и новая версия не будет перезаписана.

Документация

• Руководство пользователя

• Архитектура и границы возможностей

• Руководство для разработчиков

• Безопасность и локальные данные

• Форк и лицензия

Форк и лицензия

Codex Vault является форком Foam и использует его ядро для работы с Markdown, wikilinks и графом, добавляя плагин Codex, MCP-приложение, поддержку нескольких хранилищ и функцию заметок в чате.

Проект распространяется под лицензией MIT. Атрибуция upstream-кода и сторонних зависимостей указана в NOTICE.md. Codex Vault не является официальным продуктом OpenAI, Obsidian или Foam.