Hilbana + engram
Usa engram y Hilbana a la vez, o pasa tu memoria de engram a Hilbana: equivalencias, mapa de tipos y cómo importar el histórico.
Hilbana + engram
engram es una memoria persistente
para agentes de IA: un único binario en Go, con una base SQLite local (~/.engram/engram.db),
un servidor MCP y un plugin para Claude Code. Es de Gentleman Programming y es lo que
muchos usamos para que el agente no empiece cada sesión de cero.
Hilbana guarda memoria por proyecto con las mismas herramientas (mem_save,
mem_search, mem_context, mem_session_summary), pero en el servidor y compartida por
el workspace, junto a las issues, la cola de tareas y la revisión.
La diferencia, en una frase:
engram le da memoria a tu agente en tu máquina. Hilbana la pone donde la ven tus compañeros y sus agentes, al lado del tablero.
No hace falta elegir a la fuerza. Esta guía cubre las dos cosas: usar las dos a la vez mientras te decides, y pasarte del todo si quieres.
Cuándo te conviene cada una
| Quieres… | Usa |
|---|---|
| Memoria solo tuya, sin cuenta ni servidor, que funciona sin conexión | engram |
| Que lo que aprende un agente lo sepa el resto del equipo en su próxima sesión | Hilbana |
| Que la memoria acompañe al proyecto entre máquinas y personas sin pasos de git | Hilbana |
| Memoria enlazada a issues, con cola de tareas y revisión | Hilbana |
| Tener los datos en un fichero que controlas del todo | engram |
Si trabajas solo y en una máquina, engram te basta. Hilbana empieza a merecer la pena cuando hay más de una persona, más de una máquina, o cuando quieres que la memoria viva junto a las tareas.
Se parecen más de lo que parece
El modelo es el mismo, así que el cambio cuesta poco:
| engram | Hilbana |
|---|---|
project (el nombre del proyecto) |
scope (el nombre de la carpeta del repo) |
mem_save, mem_search, mem_context |
las mismas tres, con el mismo nombre |
mem_session_summary |
mem_session_summary |
topic_key (clave estable de un tema, sirve para actualizarlo) |
topic_key agrupa memorias del mismo tema; para sustituir una, replaces con el id de la anterior |
type: decision, bugfix, discovery… |
type: decision, bug, convention, discovery, preference, fact, note |
Una trampa: el campo scope de engram no es el scope de Hilbana. El equivalente
del scope de Hilbana es el project de engram.
Opción A · Usar las dos a la vez
Puedes tener los dos plugins instalados. Son almacenes distintos y no se pisan.
# engram, si aún no lo tienes
brew install gentleman-programming/tap/engram
engram setup claude-code
# Hilbana: dentro de Claude Code
/plugin marketplace add hilbana/claude-plugin
/plugin install hilbana@hilbana
Con los dos activos, el agente ve dos juegos de herramientas con el mismo nombre y
distinto prefijo (mcp__plugin_engram_… y mcp__plugin_hilbana_hilbana__…). Dile cuál
manda para cada cosa, o acabará guardando lo mismo dos veces. Una regla razonable:
- Hilbana: lo que el equipo debe saber (decisiones, causa raíz de un bug, convenciones del repo, trampas).
- engram: lo que solo te sirve a ti (cómo prefieres trabajar, notas personales).
Esto es una forma de repartir, no una sincronización. Nada pasa solo de engram a Hilbana ni al revés.
Opción B · Pasarte a Hilbana
El plugin de Hilbana trae un comando que te acompaña paso a paso, sin tocar nada tuyo sin preguntar:
/hilbana:memoria-switch
Lo que hace, y lo que puedes hacer tú a mano:
- Comprueba que Hilbana funciona en tu repo: guarda una nota de prueba, la busca y
la recupera con
mem_context. Si el ciclo cierra, el cambio ya va. - Convivencia unos días. Sigue guardando también en engram mientras compruebas que recuperas bien desde Hilbana. Si echas algo en falta, lo migras o lo vuelves a guardar.
- Retira el plugin de engram cuando ya no lo uses: desactívalo con
claude plugin disable engram@engram(o desde/plugin). Conserva~/.engram/engram.dbhasta haber migrado lo que quieras; borrarlo no se deshace. - (Opcional) Importa el histórico.
Importar el histórico
engram exporta a JSON:
engram export engram-export.json
En la versión 1.17.0 que probamos, engram export vuelca todos tus proyectos y no admite
--project ni --all. El README de engram describe esas opciones, así que en versiones
más recientes quizá funcionen; comprueba que el fichero solo trae lo que esperas. Con
cualquier versión sirve lo mismo: exportar todo y quedarte con el project que te interesa.
Dos cuidados con el export:
- El primer argumento es siempre el nombre del fichero.
engram export --helpoengram export --project xno muestran ayuda ni filtran: crean un fichero llamado--helpo--projectcon todas tus memorias.- Ese fichero tiene todos tus proyectos, también los personales. No lo subas a ningún sitio y bórralo cuando termines.
No hay un comando de importación masiva en Hilbana: la migración la hace tu agente,
leyendo el JSON y llamando a mem_save observación a observación. Pídeselo así:
Lee
engram-export.jsony quédate solo con las observaciones cuyoprojectseamilindri. Para cada una, guárdala en Hilbana conmem_saveconscope: "milindri", eltitley elcontentjuntos como contenido (mem_saveno tiene campo de título), eltypetraducido según la tabla y el mismotopic_key. Antes de escribir nada, enséñame un resumen: cuántas hay por tipo y a qué scope irían. Salta las de tiposession_summaryantiguas y todo lo que sea personal o solo valga en mi máquina.
Mapa de tipos que funciona bien:
| engram | Hilbana |
|---|---|
decision, architecture |
decision |
bugfix, bug, solution |
bug |
convention, pattern, config |
convention |
discovery, learning |
discovery |
feedback |
preference |
project, reference |
fact |
manual, milestone, session_summary |
note |
Dos consejos antes de importar:
- La memoria de Hilbana la ve todo el workspace. Revisa que no suba rutas absolutas, puertos locales, claves ni preferencias personales. Es la parte que más conviene mirar en el resumen previo.
- No migres todo por inercia. Un histórico con ruido hace peor al agente. Muchas veces compensa importar solo decisiones, bugs con su causa raíz y convenciones.
Qué ganas y qué pierdes
- Ganas: memoria compartida entre personas y máquinas, enlazada a issues y a la cola
de tareas;
replacespara que quede una sola versión de cada hecho. - Pierdes: funcionar sin conexión y sin cuenta, y el control total del fichero. Hilbana guarda la memoria en su servidor.
- No se traspasa: las sesiones y los prompts guardados de engram; solo las observaciones.
Consulta la documentación de engram
engram evoluciona rápido. Los comandos de esta guía salen de su README y de su
DOCS.md en el momento de escribirla; para cualquier otra cosa, el
repositorio de engram es la fuente de
verdad.
¿Quieres probarlo? Empieza gratis: 14 días de Pro al registrarte, sin tarjeta.
Relacionado: Hilbana + Claude Code · Hilbana + Beads · Hilbana + engram · Memoria de agentes · Plugin para Claude Code.