Hermes Agent: Potencia tu Segundo Cerebro

Tabla de Contenidos 26 secciones

[!abstract] En una frase Hermes Agent es un agente de IA (open source, de Nous Research) con memoria persistente, “skills” reutilizables y acceso a archivos, que puede operar sobre tu vault de Obsidian como colaborador de escritorio: leer, buscar, crear, corregir y enlazar notas, además de mantener el conjunto ordenado con el tiempo.

Hermes no es “otro plugin de resumir texto”. Es un agente con memoria en capas y ejecución de herramientas (lectura/escritura de archivos, terminal, web) que puede tratar tu carpeta de Obsidian como su directorio de trabajo.

Plugin oficial “Hermes Agent”: chatea con tu Hermes local desde una barra lateral dentro de Obsidian, con pestañas independientes por conversación. Se conecta a un gateway local (hermes gateway) vía API.
Skill “Obsidian” (filesystem-first): una skill nativa de Hermes para leer, buscar, crear y editar notas directamente como archivos, usando la variable OBSIDIAN_VAULT_PATH para saber dónde está tu vault.
Hermes Console: un plugin que abre una terminal con Hermes dentro de Obsidian; puedes seleccionar texto de una nota y pedirle que lo reescriba, lo investigue o lo cuestione sin salir del editor.
Canales externos (Telegram / Discord): puedes hablarle a Hermes desde el móvil y que él mismo escriba en tu vault — útil para capturar ideas cuando no tienes el portátil a mano.

[!tip] Modelo mental

Obsidian = la capa legible por humanos (notas, proyectos, resúmenes, enlaces).

Memoria de Hermes (memory.md, user.md, búsqueda de sesiones) = hechos estables y preferencias que debe recordar siempre.

Skills = procedimientos reutilizables que Hermes ejecuta (ej. “cómo organizo mis notas diarias”).

Sesiones = el historial efímero de conversaciones, consultable pero no destinado a vivir tal cual en tus notas.

No conviene volcar transcripciones enteras de chats en la vault: Hermes debería resumir lo relevante y guardar solo lo que aporta valor a largo plazo.

Convertir una idea suelta, un audio o un enlace en una nota nueva con estructura (título, resumen, cuerpo, enlaces relacionados).
Investigar un tema en la web y crear una “libreta de investigación” con fuentes, evidencias y un esquema del artículo.
Redactar borradores de notas de proyecto: objetivos, decisiones activas, bloqueos, rutas de archivos relevantes.
Transcribir notas de voz enviadas por Telegram/Discord y convertirlas en texto estructurado dentro del vault.

Revisión ortográfica y gramatical de notas existentes.
Reescribir un párrafo seleccionado para que sea más claro, más formal o más conciso, sin salir de Obsidian.
Homogeneizar el estilo de escritura entre notas antiguas y nuevas (mismo tono, misma estructura de encabezados).
Actualizar una nota antigua con información nueva sin perder el historial de lo que decía antes (por ejemplo, añadiendo una sección “Actualización” con fecha).

Detectar conceptos mencionados en una nota que ya existen como notas propias y convertirlos en [[wikilinks]].
Sugerir enlaces bidireccionales entre notas relacionadas que aún no se citan mutuamente.
Construir automáticamente MOCs (Maps of Content / notas índice) que agrupen notas dispersas sobre un mismo tema.
Detectar notas huérfanas (sin ningún enlace entrante o saliente) y proponer dónde deberían engancharse.
Detectar enlaces rotos (a notas renombradas o borradas) y corregirlos.

Encontrar notas duplicadas o casi duplicadas y proponer una fusión.
Detectar “stubs” (notas de una línea que nunca se desarrollaron) y decidir si ampliarlas o archivarlas.
Normalizar el frontmatter (etiquetas, fechas, tipos de nota) para que todas las notas sigan la misma convención.
Revisar etiquetas: unificar variantes como #ia, #IA, #inteligencia-artificial en una sola.
Archivar notas obsoletas moviéndolas a una carpeta archivo/ sin borrarlas.

Preguntar en lenguaje natural cosas como “¿qué decidimos sobre el proyecto X la semana pasada?” y que Hermes busque en las notas relevantes.
Pedir un resumen de todo lo relacionado con una persona, cliente o tema antes de una reunión.
Generar un resumen diario o semanal de qué notas se crearon o modificaron y qué quedó pendiente de revisar.
Revisar, antes de empezar una tarea nueva, qué recuerda Hermes sobre ese proyecto (contexto, convenciones, bloqueos anteriores).

Más allá del mantenimiento básico, así es como un agente como Hermes puede cambiar la forma en que vives con tu vault.

Un canal de Telegram o Discord actúa de bandeja de entrada: envías un enlace, una foto, una nota de voz o un pensamiento suelto, y Hermes lo procesa y lo guarda en el sitio correcto de la vault.
Los audios se transcriben y se integran como notas de captura rápida (“braindumps”), listas para pulir después.
Los enlaces se resumen automáticamente con metadatos (fuente, fecha, tres ideas clave) en lugar de guardarse como una URL suelta.

Una estructura recomendada para que el conocimiento componga en vez de acumularse como ruido:

vault/
├── SCHEMA.md          # normas de cómo se organiza todo
├── log.md             # registro de cada ingesta/actualización
├── raw/                # material fuente sin tocar (artículos, papers, tuits...)
├── wiki/               # conocimiento estructurado, curado por el agente
│   └── _index.md
└── output/             # entregables generados (informes, resúmenes, slides)

raw/ nunca se edita: es la fuente original.
wiki/ es lo que Hermes mantiene y enlaza: solo crea una página nueva cuando un concepto aparece en varias fuentes o es central en una fuente importante — evita páginas “stub” vacías.
output/ son entregables generados a partir del wiki, no al revés.

[!tip] Regla de oro Antes de crear una nota nueva, Hermes debería buscar si ya existe algo relacionado y ampliarlo, en vez de generar duplicados.

Una pasada nocturna (por ejemplo, vía cron) que revise: notas huérfanas, enlaces rotos, etiquetas sin usar, notas sin tocar hace meses.
Un informe semanal de “salud de la vault”: número de notas nuevas, notas que crecieron, notas candidatas a fusión o archivo.
Revisión periódica de memoria: Hermes propone qué hechos nuevos merecen pasar a su memoria estable (user.md), y tú los apruebas antes de que se vuelvan permanentes — un bucle de revisión humano-en-el-medio en vez de una caja negra.

Al final del día (o de una sesión larga de trabajo), Hermes redacta la nota diaria resumiendo qué se hizo, qué decisiones se tomaron y qué quedó abierto, con enlaces a los proyectos afectados.
Preguntas de cierre de día para journaling reflexivo, que Hermes convierte en una entrada estructurada en vez de texto libre sin forma.

Para tareas de código o investigación, una nota de proyecto en el vault sirve de contexto que el agente lee antes de empezar: rutas del repositorio, convenciones, bloqueos anteriores, comandos preferidos y enlaces a las skills relevantes. Así cada sesión nueva arranca con memoria real del proyecto, en vez de empezar de cero.

Un canal distinto por área de tu vida (proyectos de código, contenido, vault personal), cada uno con su propio conjunto de skills habilitadas y su propia “personalidad” de agente — así no mezclas contextos ni permisos.
Para el canal dedicado a tu vault puedes fijar instrucciones fijas tipo “usa siempre wikilinks”, “las notas diarias van en daily/”, “esta es la estructura de mi vault” — el equivalente a un archivo de instrucciones para ese canal.

Tratar la carpeta wiki/ como el contenido fuente de un sitio estático (con Hugo, MkDocs o un generador propio) publicado en tu propio dominio.
Que Hermes reconstruya el sitio automáticamente tras cada actualización relevante, vía hook de git o una tarea programada — tu jardín digital se actualiza sin que tengas que “publicar” manualmente.

Detección de contradicciones: que Hermes avise si una nota nueva contradice algo que ya escribiste en otra, en vez de dejarlas convivir en silencio.
Plantillas inteligentes: en vez de plantillas estáticas, que Hermes rellene la plantilla adecuada según el tipo de nota que le pidas (reunión, libro, persona, proyecto).
Repaso espaciado: generación de tarjetas de repaso (flashcards) a partir de notas de estudio, para reforzar lo que quieres memorizar.
Bibliografía y fuentes: mantener actualizada una nota de referencias con los enlaces y citas usados en tus notas de investigación.
Traducción y accesibilidad: traducir notas puntuales sin romper el formato ni los wikilinks.
Resúmenes ejecutivos: para notas muy largas, generar automáticamente un resumen de 3-5 líneas al principio, sin tocar el cuerpo original.
Reorganización de carpetas: proponer una reestructuración de carpetas cuando detecta que una carpeta ha crecido demasiado o mezcla temas distintos.
Recordatorios de revisión: marcar notas “para revisar en 3 meses” y que Hermes te las recuerde cuando llegue el momento.

[!warning] Empieza pequeño No le des a un agente el vault completo el primer día.

Alcance limitado: empieza con una sola carpeta, escribe una nota inofensiva, verifica el resultado en Obsidian y solo entonces amplía el alcance.
Secretos fuera del vault: las claves de API y credenciales nunca deben vivir dentro de las notas.
Copia de seguridad: usa el mismo flujo de backup (Git, iCloud, backup local) que ya usas para Obsidian, también para la memoria del agente.
Revisión humana de la memoria: antes de dar acceso amplio a proyectos o integraciones, revisa qué está aprendiendo el agente sobre ti.
Cuidado con Docker/SSH: si Hermes corre en un contenedor o servidor remoto, confirma que la carpeta de tu vault está realmente montada y visible — si algo falla, comprueba antes la ruta y los permisos de archivo que la memoria.
Evita el “todo en una nota”: separa memoria (hechos compactos y estables), sesiones (historial efímero) y vault (notas largas, legibles, enlazables). Mezclarlo todo en una nota gigante hace imposible saber qué está vigente y qué no.

Instalar o actualizar Hermes Agent y correr hermes doctor para comprobar que todo está sano.
Confirmar que hermes chat -q "..." funciona antes de tocar el vault.
Definir OBSIDIAN_VAULT_PATH apuntando a tu vault real.
Elegir una única carpeta de trabajo inicial (no el vault entero).
Pedirle que cree una nota de prueba sencilla y revisarla en Obsidian.
Si usas el plugin oficial: activar el gateway (hermes gateway) y conectar el plugin con tu clave de API.
Ampliar el alcance poco a poco: notas de proyecto → investigación → limpieza y enlazado automático.

---
tags: [proyecto]
estado: activo
creado: {{date}}
---

# Nombre del proyecto

## Objetivo
Qué se busca conseguir.

## Contexto y decisiones activas
- Decisión 1
- Decisión 2

## Bloqueos actuales
-

## Rutas y recursos relevantes
- Repositorio / carpeta: `...`
- Skills relacionadas: [[Skill: ...]]

## Notas relacionadas
- [[...]]

Bash

cd hermes-agent
source .venv/bin/activate
python -m tui_gateway.entry

Bash

cd hermes-agent/ui-tui
npm run dev

Cuando se abra su pantalla visual en la terminal, no tienes que programar. Le hablas usando comandos como este:

/goal Prepara la nota 'Mi Viaje' de Obsidian para publicarla en Astro

Él solito se encargará de buscar el archivo, estructurarlo y dejarlo listo. Es, literalmente, un puente inteligente entre tus notas personales y tu sitio web.