Soluciones
Deja de volver a explicar tu proyecto
Cierras un agente, abres otro, y ya conoce la arquitectura, los enfoques que fallaron y lo que sigue abierto. Funciona igual desde tu equipo de escritorio y desde tu portátil, y no necesita clave de API.
Cambia de agente a mitad de una tarea
A las 4 de la tarde te topas con un rate limit en Claude Code. Abre Codex en el mismo directorio y sigue.
Tipado
Un traspaso lleva un resumen de la sesión, los próximos pasos y las preguntas abiertas. El siguiente agente lo recibe al iniciar la sesión, antes de que escribas nada.
Se reclama una sola vez
La primera sesión que arranca en ese directorio se lleva el testigo. Una segunda que lo pida no recibe nada, así que dos agentes nunca retoman el mismo trabajo.
Automático, y puedes imponer el tuyo
Cada fin de sesión escribe uno. Di “guarda el contexto para la próxima sesión” para escribir el tuyo, que tiene prioridad sobre el automático.
Dos agentes, Grok Build CLI y Zero, ignoran lo que los hooks imprimen al iniciar la sesión. Pídeles que acepten el traspaso y lo traen por MCP. La página de integraciones lista todos los agentes y lo que soporta cada uno.
Lo que dices en el día a día
La mayoría de los días no dices nada. Los hooks capturan la sesión y, al terminar, esta se convierte en páginas de la wiki. Cuando quieres algo, la interfaz es lenguaje natural.
- “¿Dónde lo dejamos?”
- Lee el traspaso pendiente: resumen, próximos pasos y preguntas abiertas.
- “¿Ya hablamos de X?”
- Busca en la wiki con texto completo, entidades, enlaces y vectores fusionados en un solo ranking.
- “Ponme al día. He estado fuera.”
- Arma un resumen que se alarga cuanto más tiempo llevas fuera. Es prosa si hay un LLM configurado y datos estructurados si no lo hay.
- “Recuerda esto para siempre.”
- Escribe una página duradera, versionada en git. Fíjala y nunca decae.
- “Recuerda esto hasta el viernes.”
- Escribe la página con fecha de caducidad. El barrido de olvido la borra pasada esa fecha.
- “Esa página está desactualizada.”
- Registra un feedback que baja la página en los próximos rankings. El feedback nunca borra nada.
La guía de uso en GitHub tiene la lista completa de frases y la herramienta MCP que hay detrás de cada una.
Un solo lanzador, y una entrada para proyectos viejos
Arranca tu agente con ai-memory run
- El primer arranque instala los hooks y la entrada MCP de ese agente si faltan. Lo hace una vez por agente.
- Al cambiar de agente se retoma la misma línea de trabajo, con el historial visible además del resumen del traspaso.
ai-memory continueencuentra tu checkout más reciente desde cualquier directorio y retoma ahí.- Hoy cubre 12 agentes. Lanzar un agente directamente sigue funcionando, y los hooks por sí solos ya llevan el traspaso.
cd /path/to/project
ai-memory run claude
# Cierra Claude Code y sigue la misma línea de trabajo en Codex.
ai-memory run codex --yolo
# Desde cualquier directorio: llévame adonde estaba.
ai-memory continue
Incorpora un proyecto que ya tienes
La primera sesión en un proyecto vacío importa una vez tu historial local de agentes, con un tope de las 25 sesiones más recientes. También puedes ejecutarlo a mano.
# Mira qué se importaría y luego impórtalo
ai-memory backfill --dry-run
ai-memory backfill
Desactiva la importación automática del primer arranque con AI_MEMORY_BACKFILL_ON_START=false.
# Necesita un proveedor de LLM en el servidor
ai-memory bootstrap --dry-run
ai-memory bootstrap
Bootstrap lee el git log, el README, docs/ y tus archivos de reglas. El proyecto midió una ejecución en bastante menos de 0,20 USD con Kimi 2.6 a través de OpenRouter. Puede escribir páginas que suenan bien y están mal, así que lee antes la simulación (dry run).
La misma memoria en tu escritorio y en tu portátil
Ejecuta un servidor pequeño y apunta todas tus máquinas a él. Un proyecto se identifica por el nombre de su checkout, así que rutas distintas en cada máquina acaban en la misma memoria.
- Pon el servidor en un equipo del homelab o en la máquina que se quede encendida. Es un solo binario o un solo contenedor.
- Cuando el portátil está sin conexión, los eventos de los hooks van a una cola local (spool) y se vuelcan cuando el servidor vuelve a estar accesible. Cada entrada lleva una clave de idempotencia, así que nada se guarda dos veces.
ai-memory statusmuestra cuántos eventos hay pendientes y la antigüedad del más viejo.- Un servidor que escucha más allá de loopback exige un bearer token. El token no cifra el tráfico, así que añade TLS antes de salir de tu LAN.
# En el equipo de escritorio y en el portátil
export AI_MEMORY_SERVER_URL="http://<server-ip>:49374"
export AI_MEMORY_AUTH_TOKEN="$TOKEN"
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --apply
Sin clave de API, y con archivos que puedes leer
La instalación por defecto no cuesta nada de ejecutar y guarda todo como markdown en un repositorio git.
Cero llamadas a un LLM
La captura, los resúmenes de sesión, los traspasos y la búsqueda funcionan sin modelo. Los resúmenes se generan con reglas hasta que añades un proveedor.
Los embeddings corren dentro del binario
Un modelo local pequeño (all-MiniLM-L6-v2, unos 87 MB) se descarga una vez en segundo plano. La búsqueda vectorial se activa en el siguiente reinicio. No necesita clave ni GPU.
Solo loopback
El servidor por defecto escucha en 127.0.0.1:49374, sin cuenta y sin telemetría. Nada más en la red puede llegar a él.
Llévate los archivos adonde quieras
El índice SQLite se deriva de los archivos y se puede reconstruir a partir de ellos. Haz la copia de seguridad con ai-memory backup, con rsync o con un git push a tu propio remoto.
# Copia la wiki fuera del contenedor y ábrela en Obsidian
docker cp ai-memory:/data/wiki ./my-ai-memory-wiki
# O lee su historial
git -C /data/wiki log --oneline
O navégala en una interfaz web de solo lectura
Un flag añade una vista en el navegador con la lista de proyectos, el árbol de páginas, el markdown renderizado, la búsqueda y enlaces de wiki en los que puedes hacer clic. No puede editar nada.
ai-memory serve --transport http --bind 127.0.0.1:49374 --enable-web
# luego abre http://127.0.0.1:49374/web
¿Lo necesitas?
Preguntas y respuestas
¿Necesito una clave de API o un LLM para usar ai-memory?
No. La captura, los resúmenes de sesión, los traspasos y la búsqueda funcionan sin ninguna llamada a un LLM. Los embeddings de la búsqueda vectorial corren dentro del proceso con un modelo local. Un proveedor de LLM es opcional y aporta una consolidación más rica, bootstrap y reranking.
¿Tengo que usar ai-memory desde el primer día de un proyecto?
No. Añádelo en cualquier momento. La primera sesión en un proyecto que todavía no tiene memoria importa las sesiones de agentes que ya están en tu máquina, de todos los agentes compatibles, hasta las 25 más recientes. Se ejecuta una vez, en segundo plano y sin LLM. ai-memory bootstrap también puede construir páginas a partir del git log, el README y tus docs, y ese sí necesita un LLM.
¿Puedo usar la misma memoria en un equipo de escritorio y en un portátil?
Sí. Ejecuta un servidor de ai-memory en un equipo del homelab o en una de las máquinas y apunta las dos a él. No hay replicación entre servidores. Si el portátil está sin conexión, los eventos de los hooks se acumulan en una cola local y se vuelcan cuando el servidor vuelve a estar accesible.
¿Basta con la memoria integrada de Claude Code?
Para un desarrollador en una sola máquina que solo usa Claude Code, puede que sí. Deja de bastar cuando sumas un segundo agente, una segunda máquina o una segunda persona.
¿Dónde se guarda mi memoria?
En una carpeta de archivos de markdown plano versionada con git, dentro del directorio de datos de ai-memory. SQLite guarda un índice de búsqueda que se puede reconstruir a partir de los archivos.
Dale memoria a tus agentes hoy.
Gratis y de código abierto. No necesitas cuenta ni clave de API, y los archivos siguen siendo tuyos.