Soluciones
Deja de volver a explicar tu proyecto
Guarda decisiones, intentos fallidos y trabajo pendiente para la próxima sesión del agente. Un PC y un portátil pueden compartir esa memoria cuando acceden al mismo servidor. Las funciones predeterminadas de memoria no necesitan clave API de proveedor de modelos.
¿Lo necesitas?
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.
Claude Code
ai-memory
Traspaso
Codex
Reclamo único
Resumen
Próximos pasos
Preguntas abiertas
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.
Aunque nada se haya cerrado
Un límite de cuota o un fallo no escribe ningún handoff. La sesión siguiente recibe el nombre de ese trabajo sin terminar y puede leer sus observaciones.
Se reclama una sola vez
La primera sesión apta reclama el traspaso. Una segunda solicitud no puede reclamar el mismo. Esto evita entregar dos veces ese traspaso, pero no impide que dos agentes elijan trabajos similares por su cuenta.
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 comentarios para retención y lint. No cambia el orden de búsqueda ni elimina la página directamente.
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 y conecta tus máquinas a él. Por defecto, la identidad del proyecto procede del remoto Git; las carpetas sin un remoto válido usan el nombre del directorio. Los archivos marcadores pueden cambiarlo, así que comprueba el proyecto resuelto al conectar una segunda máquina.
PC
Un servidor ai-memory
Portátil
Sin conexión
Cola local
Un servidor ai-memory
Se vacía después
- 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.- El acceso remoto necesita un token bearer y TLS, incluso dentro de tu LAN. Configura ambos antes de conectar otra máquina.
# En el equipo de escritorio y en el portátil
export AI_MEMORY_SERVER_URL="https://memory.example.com"
export AI_MEMORY_AUTH_TOKEN='REPLACE_WITH_YOUR_SERVER_TOKEN'
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --apply
# luego lanza como siempre
ai-memory run claude
Memoria local y archivos legibles
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.
wiki/ markdown plano
grep
Obsidian
Editar
rsync
historial de git
Llévate los archivos adonde quieras
Puedes leer y editar las páginas Markdown. Reindex reconstruye su índice de búsqueda, pero las sesiones, traspasos y cuentas también necesitan la base. Usa ai-memory backup; un git push solo de la wiki no es una copia completa.
# 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
Un navegador para tu memoria
Una opción abre el panel en el navegador con proyectos, actividad, páginas guardadas, búsqueda y buzones. Las páginas de la wiki siguen siendo de solo lectura; los usuarios autorizados pueden enviar o editar mensajes pendientes.
ai-memory serve --transport http --bind 127.0.0.1:49374 --enable-web
# luego abre http://127.0.0.1:49374/web
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?
Reindex reconstruye páginas, enlaces y búsqueda de texto desde Markdown. No recupera sesiones, observaciones, traspasos, usuarios, claves ni auditoría que solo existen en la base.
Dale memoria a tus agentes hoy.
Gratis y de código abierto. Las funciones predeterminadas de memoria no necesitan clave de proveedor de modelos y los datos son tuyos.