Codex Vault

Codex Vault es un plugin local para la aplicación de escritorio Codex que lee bóvedas Markdown compatibles con Obsidian, busca notas, muestra backlinks y el grafo de conocimiento, y añade el contenido seleccionado al contexto del chat.

[!IMPORTANT] El proyecto está en desarrollo temprano y solo se prueba a través del marketplace personal; aún no se ha publicado públicamente.

Funciones

• Navegar y buscar Markdown, wikilinks, tags y frontmatter.

• Mostrar backlinks, notas aisladas, enlaces rotos y el grafo de conocimiento.

• Seleccionar texto y añadirlo como comentario, adjuntándolo al compositor de Codex; no se envía automáticamente.

• Acumular múltiples comentarios, cada uno conserva la ruta de la nota, el texto y el número de línea.

• Leer y escribir notas de forma segura mediante herramientas MCP; la escritura está desactivada por defecto.

Related MCP server: vault-master-mcp

Uso

Después de la instalación, crea una nueva tarea de Codex, selecciona @Codex Vault y escribe «Abrir Vault Explorer». Después de actualizar el plugin también debes usar una tarea nueva; las tareas existentes no recargan las herramientas MCP en caliente.

Añadir comentarios:

1. En el lector de Markdown, selecciona texto y pulsa «Añadir al chat».

2. Escribe un comentario si lo deseas y vuelve a pulsar «Añadir al chat».

3. Vuelve al compositor, escribe tu pregunta y solo al enviarla se entregará al modelo junto con los comentarios.

Los comentarios solo existen en el contexto del chat y no se escriben de vuelta en el Markdown.

Límites de capacidades

• Esto es un plugin de Codex y una aplicación MCP, no un fork de la aplicación Codex.

• No se puede instalar como un panel lateral fijo de la UI privada de Codex ni controlar el menú de modelos.

• Los comentarios usan la API pública updateModelContext(), no el modelo de datos privado de comentarios de Codex.

• Actualmente se valida principalmente en macOS; otras plataformas aún no se han probado por completo.

Desarrollo

Requisitos: Node.js 22+, Yarn Classic 1.x y una aplicación Codex compatible con Plugins/MCP Apps.

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

En entornos con un marketplace personal configurado se puede ejecutar:

codex plugin add codex-vault@personal
codex plugin list

Ejecutar directamente ./scripts/launch_codex_vault_mcp solo inicia el servidor stdio, no muestra la UI de Codex. El flujo completo de actualización se describe en la guía de desarrollo.

Escritura

Establece CODEX_VAULT_ALLOW_WRITES=true, o haz que el contenido de ~/.config/codex-vault/allow-writes sea true, para habilitar las herramientas de escritura.

Para modificar una nota existente, primero debes llamar a preview_resource_update y luego llamar a update_resource con el SHA-256 devuelto; si el archivo ha cambiado, devolverá conflict y no sobrescribirá el contenido nuevo.

Documentación

• Guía de uso

• Arquitectura y límites de capacidades

• Guía de desarrollo

• Seguridad y datos locales

• Fork y licencia

Fork y licencia

Codex Vault deriva de Foam, conserva su núcleo de Markdown, wikilinks y graph, y añade el plugin de Codex, la aplicación MCP, la gestión de múltiples bóvedas y los comentarios de chat.

Este proyecto está bajo Licencia MIT. La atribución del upstream, del código derivado de Microsoft y de las dependencias de terceros se encuentra en NOTICE.md. Codex Vault no es un producto oficial de OpenAI, Obsidian ni Foam.