VibeDNA Journal

Un archivo de diario por proyecto que tu IA lee al inicio de la sesión y actualiza mientras trabaja.

Documentación

Diario de VibeDNA Journal MCP

Un archivo de diario por proyecto que tu IA lee al inicio de la sesión y actualiza mientras trabaja.

El diario le da a cada proyecto un archivo Markdown plano (*_JOURNAL.md). Tu IA lo lee cuando comienza una sesión y le añade contenido a medida que se entrega el trabajo: decisiones con sus razones, errores con su causa raíz y solución, estado actual, hoja de ruta y una nota de traspaso para la próxima sesión. La búsqueda de texto completo clasificada encuentra una entrada en todos los diarios de todos los proyectos a la vez. Una herramienta opcional añade una regla a tu CLAUDE.md para que Claude Code mantenga el hábito sin que se lo pidan.

Se ejecuta localmente a través de stdio. Python 3.10+ y el paquete mcp.
El núcleo del diario no realiza llamadas de red. Tus diarios permanecen en tu disco.
Las herramientas opcionales del marketplace exploran y descargan diarios de vibedna.ai, solo cuando las llamas.

Página de inicio: https://vibedna.ai/store/journal

Herramientas (25)

Ponte al día con un proyecto

Herramienta	Qué hace
`journal_handoff_brief(name)`	Resumen breve: encabezado más las últimas entradas
`journal_read(name, max_kb)`	Contenido completo del diario
`journal_read_section(name, section)`	Una sección, p. ej. `Current state` o `Handoff for next session`
`journal_list_sections(name)`	Las secciones H2 de un diario
`journal_list(project, last_days)`	Lista los diarios en el índice

Registra el trabajo a medida que se entrega

Herramienta	Qué hace
`journal_append(name, entry, tag)`	Entrada con marca de tiempo
`journal_update_section(name, section, new_content, mode)`	Reemplaza, añade al final o al principio una sección
`journal_create(name, project_dir, body)`	Nuevo diario con las secciones estándar

Búsqueda

Herramienta	Qué hace
`journal_search(query, project)`	Búsqueda de texto completo clasificada (SQLite FTS5) en todos los diarios, con fragmentos
`journal_recent_changes(last_hours)`	Diarios actualizados recientemente
`journal_stats()`	Totales, diarios más grandes y más recientes
`journal_browse(domain, tier, kind, tag)`	Explora la biblioteca local por metadatos
`journal_market_index(kind)`	Fuente local de diarios de un tipo, con metadatos
`journal_overlap_check(name)`	Encuentra diarios que se superponen con este

Configuración

Herramienta	Qué hace
`journal_index_refresh()`	Vuelve a escanear las raíces en busca de archivos de diario
`journal_config_add_root(path)`	Añade una carpeta para escanear
`journal_get_claude_rule()`	El texto de regla `CLAUDE.md` recomendado
`journal_install_rule(scope, confirm)`	Instala esa regla (vista previa a menos que `confirm=True`)
`journal_backup_to_drive(name, remote, remote_folder)`	Copia diarios a tu propio remoto rclone (opcional)
`check_for_update()`	Compara esta copia con la versión publicada
`vibedna_info()`	Metadatos del producto

Marketplace (opcional, llega a vibedna.ai)

Herramienta	Qué hace
`journal_market(query, domain)`	Explora el estante de diarios de VibeDNA
`journal_pair(token)`	Vincula esta instalación a una cuenta de vibedna.ai
`journal_get(slug)`	Descarga un diario que posees, u obtén un enlace de pago para uno que no posees
`journal_library()`	Lista los diarios que posees

Instalación

git clone https://github.com/marstudio360/vibedna-journal-mcp
cd vibedna-journal-mcp
pip install -r requirements.txt

JOURNAL_ROOTS es la lista de carpetas para escanear en busca de archivos de diario, separadas por ;. Sin ello, Journal escanea ~/Desktop y ~/Documents.

Claude Code

claude mcp add journal --scope user -e JOURNAL_ROOTS="/path/to/your/projects" -- python /absolute/path/to/vibedna-journal-mcp/server.py

O en el .mcp.json de un proyecto:

{
  "mcpServers": {
    "journal": {
      "command": "python",
      "args": ["/absolute/path/to/vibedna-journal-mcp/server.py"],
      "env": { "JOURNAL_ROOTS": "/path/to/your/projects" }
    }
  }
}

Luego pídele a Claude: "Instala la regla del diario CLAUDE.md globalmente." Ese es el paso que hace que lea y escriba los diarios por sí solo.

Cursor

Añade el mismo bloque mcpServers a ~/.cursor/mcp.json (todos los proyectos) o .cursor/mcp.json (un proyecto).

Claude Desktop

Añade el mismo bloque mcpServers a claude_desktop_config.json (Configuración > Desarrollador > Editar configuración), luego reinicia Claude Desktop.

INSTALL.md es una guía paso a paso escrita para que puedas pegarla en un chat de IA y dejar que la IA haga la instalación.

Configuración

Variable	Predeterminado	Qué hace
`JOURNAL_ROOTS`	`~/Desktop;~/Documents`	Carpetas para escanear en busca de archivos `JOURNAL.md`
`JOURNAL_HOME`	`~/.journal`	Dónde viven el índice de búsqueda y la configuración opcional
`JOURNAL_TRANSPORT`	`stdio`	`http` sirve HTTP transmisible en `PORT`, solo para alojamiento en la nube

Estructura del diario

journal_create inicia cada diario con estas secciones:

## Vision / Why this exists
## Current state
## Roadmap
## Decisions log
## Incidents
## Handoff for next session
## Recent entries

Seguridad

Consulta SECURITY.md para ver qué lee, escribe y envía el servidor.

Licencia

Soporte: admin@vibedna.ai