Hace una semana conecté formalmente Hermes Agent a mi vault de Obsidian y me puse un reto: dejar que se encargara de todo el trabajo con notas de forma automática durante siete días. El resultado me sorprendió — no porque me ahorrara tiempo, sino porque mi vault cobró vida por primera vez. El resumen de la mañana estaba listo cuando me despertaba, la bandeja de entrada se vaciaba sola cada noche, y lo más llamativo fue un grafo semántico dibujado automáticamente que me puso delante conexiones que nunca había hecho explícitas. Este es el registro completo de la semana, incluidas las dos vías oficiales para conectar — y un aviso: el comando hermes memory setup --provider obsidian que circula por las comunidades chinas no existe en el código oficial. No lo copies.

Las dos vías oficiales

Vía A: el skill oficial de obsidian incorporado (leer/escribir notas)

Hermes trae un skill obsidian de serie (categoría note-taking, de Teknium). Trata tu vault como un espacio de trabajo centrado en el sistema de archivos: leer notas, listarlas, búsqueda de texto completo, crear notas, añadir contenido, ediciones puntuales y añadir wikilinks — todo a través de las herramientas de archivos oficiales, sin rodeos de MCP.

• La ruta del vault se configura mediante la variable de entorno OBSIDIAN_VAULT_PATH (por defecto ~/Documents/Obsidian Vault si no se define);
• Las rutas con espacios no son un problema (las herramientas de archivos las manejan de forma nativa);
• Las notas nuevas se enlazan entre sí con la sintaxis [[Note Name]] — el alma de Obsidian, y el skill lo trata como una regla.

Uso en una línea: define OBSIDIAN_VAULT_PATH en tu .env y luego solo dile a Hermes “lee la nota diaria de hoy” o “guarda esto como una nota y enlázala con temas relacionados”.

Vía B: el plugin de la comunidad de Obsidian (vault como directorio de trabajo)

Un paso más allá del skill está el plugin de la comunidad Hermes Agent (jsun2020/hermes-agent-obsidian-plugin, MIT). Convierte Obsidian en un frontend para Hermes:

• Chat lateral con múltiples pestañas: un panel de conversación integrado en Obsidian que usa el Runs transport del gateway (flujos de eventos de herramientas/razonamiento) con Chat Completions como respaldo;
• Adjuntar contexto con un clic: envía la nota actual o una selección directamente a Hermes — sin copiar y pegar;
• Vault como directorio de trabajo: define una carpeta de trabajo y el agente puede leer, escribir, buscar y ejecutar flujos de trabajo de varios pasos de verdad sobre tus notas — esto es lo que hizo posible “una semana de automatización”;
• Smart Graph: Hermes lee los resúmenes de las notas y saca a la luz conexiones semánticas (temas compartidos, una nota que desarrolla otra, prerrequisitos/dependencias, contradicciones), renderizadas como un force-directed graph interactivo — la vista Graph nativa de Obsidian solo conoce los [[wikilinks]] explícitos; Smart Graph encuentra los que sentías pero nunca escribiste. Los resultados se guardan en caché, así que el grafo sobrevive al reinicio.

La autenticación usa la API_SERVER_KEY del gateway (generada automáticamente por Hermes Desktop, en ~/.hermes/.env). Se instala mediante el plugin de la comunidad BRAT, o manualmente con el trío main.js / manifest.json / styles.css.

La semana, día a día

• 6:30 cada mañana: se dispara un trabajo de cron; Hermes lee la nota diaria de ayer y el overview.md de cada proyecto, y escribe “qué importa hoy + estado del proyecto en una línea + bucles abiertos” en 04 - HERMES-OUTPUTS/briefings/ — cinco minutos de lectura antes de cualquier notificación, y supera a las noticias.
• 20:00 cada noche: el procesador de la bandeja de entrada clasifica todo lo que se ha volcado en 00 - INBOX/, lo archiva y obliga a que cada nueva nota permanente lleve al menos un wikilink — sin conexiones, no hay carpeta permanente. Tras una semana, la bandeja nunca acumuló pendientes.
• En cualquier momento: selecciono un buen artículo, lo envío al chat lateral, “lee esto y conviértelo en una nota de literatura” — y devuelve la nota con fuentes y enlaces adjuntos.
• Sorpresa del fin de semana: ejecuté Smart Graph y conectó una nota sobre mi flujo de escritura de hace tres meses con las notas de proyecto de esta semana — no tenía ni idea de que estuvieran relacionadas. Esa conexión se convirtió en la semilla de mi siguiente artículo.

Escollos con los que me topé (registro honesto)

1. Sandbox de solo lectura de Codex / gpt-5.5: con los modelos de la familia OpenAI-Codex, el agente se ejecuta en un sandbox de solo lectura, así que las lecturas de rutas del vault son rechazadas (“two read-only permission requests were rejected”). Solución: en ~/.codex/config.toml, define sandbox_mode = "workspace-write" y añade tu vault a [sandbox_workspace_write].writable_roots, y luego reinicia Hermes Desktop (el gateway carga la configuración al arrancar). En entornos Windows muy restringidos puede hacer falta danger-full-access cuando el sandbox ni siquiera puede arrancar.
2. El TUI no es el gateway: el plugin habla con el gateway HTTP (por defecto 127.0.0.1:8642); con ejecutar solo el chat del TUI no basta — debe estar levantado hermes gateway o Hermes Desktop.
3. Los profiles con nombre mueven el puerto: con profiles con nombre, el gateway se enlaza a 8643–8742; solo hay que actualizar la URL base en los ajustes del plugin.
4. No uses el comando falso: hermes memory setup --provider obsidian no existe en el código oficial — Obsidian no es un proveedor de memoria; es un espacio de trabajo para el skill + el plugin.

Inicio rápido (las dos vías)

# Vía A: skill oficial (leer/escribir notas)
echo "OBSIDIAN_VAULT_PATH=$HOME/Documents/Obsidian Vault" >> ~/.hermes/.env
# Luego en el chat: /skill obsidian, o simplemente "usa el skill de obsidian para leer mi nota diaria"

# Vía B: plugin (vault como directorio de trabajo)
# 1. En Obsidian, instala BRAT → añade https://github.com/jsun2020/hermes-agent-obsidian-plugin
# 2. En los ajustes, rellena la URL del gateway (por defecto http://127.0.0.1:8642) + API_SERVER_KEY
# 3. Haz clic en Test connection y abre el chat lateral

Para la programación (resúmenes matutinos, procesamiento de la bandeja de entrada), la orquestación la hace el cron de Hermes — consulta la guía completa de automatización con cron. Para aislar vaults por profile: múltiples instancias independientes en una máquina. El artículo anterior sobre convertir conversaciones en notas cubre el pipeline de captura en una dirección; este es el espacio de trabajo bidireccional — se complementan.

Conclusión

Tras una semana de “automatización total”, mi mayor aprendizaje: Obsidian y Hermes son una pareja natural — Obsidian aporta la capa de conocimiento legible por humanos, permanente y enlazable; Hermes aporta la capa de cerebro que piensa, recuerda y ejecuta según un horario. El skill oficial se encarga de leer/escribir, el plugin de la comunidad de la colaboración bidireccional y el descubrimiento semántico, y cron de los tiempos. Ignora los comandos inventados que circulan por los foros chinos; sigue las dos vías oficiales y tu vault también cobrará vida en una semana.