ai-memory: cambia de Claude Code a Codex sin explicar el proyecto otra vez

¿Comentaste AKITA? Aquí tienes el enlace y el paso a paso. ai-memory es una herramienta gratis y de código abierto que da memoria a los agentes de IA que programan (Claude Code, Codex, Cursor, Gemini CLI y más de 20 otros). Mientras trabajas, toma notas solo: lo que pediste, lo que falló y lo que quedó pendiente. Así, si el límite de Claude se acaba a mitad de la tarea, Codex empieza sabiendo dónde lo dejaste, en vez de que expliques todo otra vez.

Logo oficial del proyecto (README, licencia MIT, Fabio Akita).

Antes de nada, cinco verdades:

• ai-memory es gratis, la IA no. Es gratis y de código abierto (licencia MIT). Claude Code y Codex siguen con el plan de cada uno: el límite y el cobro de tu plan siguen valiendo.
• No “recuerda todo”. El siguiente agente recibe un traspaso: dónde lo dejaste, qué falló y qué quedó pendiente, y puede buscar el resto. El propio sitio avisa que lo que vuelve puede llegar incompleto o desactualizado (aimemory.sh, 30/10/2026).
• Es para quien ya usa un agente de código (Claude Code, Codex y similares). Si solo usas ChatGPT o Claude en el navegador, todavía no hace nada por ti.
• Se instala desde la Terminal. En Mac y Linux son dos comandos de copiar y pegar. En Windows, el camino recomendado es WSL2; el Windows “normal” es experimental (README, 30/10/2026). No funciona en el móvil.
• Los pasos vienen de la documentación oficial y NO LOS HEMOS PROBADO. Las imágenes son capturas de páginas públicas y una imagen del propio README.

Cómo funciona, en palabras simples

Piensa en ai-memory como un cuaderno de obra que se rellena solo:

1. Una grabadora que se enciende sola. Cuando usas el agente, unos “disparadores” (hooks) anotan tus pedidos, los comandos que ejecutó el agente y el inicio y el fin de cada sesión. No tienes que pedir “recuerda esto” (README).
2. Se convierte en un archivo de texto que es tuyo. Al final de la sesión, esas notas se convierten en una página de texto (markdown) en la “wiki” del proyecto, guardada en tu ordenador. Puedes abrirla, leerla, buscar en ella e incluso editarla a mano.
3. El siguiente agente empieza sabiendo. Cuando abres otro agente en la misma carpeta, recibe un resumen corto de dónde lo dejaste, qué falló y qué quedó pendiente, y puede buscar el resto cuando lo necesite.
4. Sin clave de API. Ese camino por defecto no llama a ninguna IA para funcionar. La IA que piensa sigue siendo la de tu plan.

Las cuatro etapas en el sitio oficial: grabar, ordenar, recordar y pasar el relevo. Capturado el 30/10/2026.

El camino más simple

Paso de la documentación, no probado por nosotros. No necesitas programar, pero vas a copiar y pegar comandos en la Terminal. Cada comando tiene un botón de copiar.

curl -fsSL https://github.com/akitaonrails/ai-memory/releases/latest/download/install.sh | sh

Instala ai-memory siguiendo exactamente las instrucciones de https://cauhi.com/learn/ai-memory/INSTALL_FOR_AGENTS.md y enséñame cada comando antes de ejecutarlo.

ai-memory setup

ai-memory run claude

ai-memory run codex

Sigue desde donde lo dejamos: dime qué se intentó, qué falló y cuál es el siguiente paso antes de tocar ningún archivo.

Lo que es verdad (y lo que el vídeo simplificó)

• “Gratis”: ai-memory es gratis (MIT). Claude Code y Codex siguen con el plan de cada uno, con el límite y el cobro de siempre.
• “Recibe un resumen de dónde lo dejaste”: sí, un traspaso con dónde lo dejaste, qué falló y qué quedó pendiente. No “recuerda todo”, y lo que vuelve puede llegar incompleto.
• “Una semana después se echó atrás”: en su post del 23/05/2026, Akita cuenta que había recomendado otra herramienta de memoria cinco días antes y se echó atrás después de una semana usándola, por una ventana de pérdida de datos y notas que desaparecían en silencio. Ahí empezó ai-memory.
• “Más de 20 agentes”: el README dice “more than twenty” y su tabla de soporte lista unos 35. No es “cualquier agente”.
• Las pantallas de Claude y Codex del vídeo (el pedido del encargo, las soluciones que fallan, el aviso de límite, la barra de uso y la página de sesión) son una ilustración de un uso posible. La pantalla de memoria web es la imagen real del README. No probamos la herramienta.

Para ir más allá

Opcional. Paso de la documentación, no probado por nosotros (README, INSTALL_FOR_AGENTS.md, docs/windows.md, docs/install.md y docs/managed-workstreams.md, commit 8cb9722, 30/10/2026).

Instalar como plugin (Claude Code o Codex)

El binario se sigue instalando como en el paso 2; el plugin solo conecta el agente:

claude plugin marketplace add akitaonrails/ai-memory && claude plugin install ai-memory@ai-memory

codex plugin marketplace add akitaonrails/ai-memory && codex plugin add ai-memory@ai-memory

Después Codex te pide confiar en los disparadores de /hooks.

Windows

• Dentro de WSL2 (recomendado): usa los comandos de Linux de los pasos 2 y 3 y abre el agente también dentro de WSL2. No mezcles: si el agente corre en WSL2, ai-memory tiene que estar en WSL2 (docs/windows.md).
• Windows nativo (experimental), en PowerShell, sin administrador:

irm https://github.com/akitaonrails/ai-memory/releases/latest/download/install.ps1 | iex

Después ejecuta ai-memory setup. En Windows enciende el servidor cuando inicias sesión, sin ventana de consola.

Otras formas de instalar

• Arch Linux (AUR): yay -S ai-memory-bin (binario listo) o yay -S ai-memory (compila), después ai-memory setup.
• Fedora: descarga el RPM de la última release y ejecuta sudo dnf install ./ai-memory-*.rpm, después ai-memory setup.
• App de barra de menú de Mac, Docker y NixOS: existen, pero requieren compilar o más configuración. Están en el README del proyecto (enlace en los créditos).

Opciones de setup

Comandos del día a día con ai-memory run

Dentro del agente puedes preguntar cosas como “¿dónde lo dejamos?”, “¿ya hablamos de X?” o “ponme al día” (README, “Everyday use”).

Detalles que conviene saber:

• La copia del historial de Claude solo existe en el mismo ordenador. En otra máquina solo llega el traspaso del servidor.
• Si tu claude es un alias del shell, ai-memory run no lo ve; usa un script con el mismo nombre en el PATH o --executable.
• Para no grabar una carpeta, usa [capture] ignore_paths en el archivo .ai-memory.toml del proyecto.
• IA opcional: con una clave de API configurada, los resúmenes mejoran y se activa la búsqueda por significado. Sin clave, todo sigue funcionando (README, “LLM providers”).
• Equipos: puedes tener un servidor para todos, con login, autoría y registro de auditoría, sin plan de pago (README, “Teams and multiple machines”).

Instrucciones oficiales para agentes, aquí en el sitio (MIT, Fabio Akita, sin cambios, en inglés): INSTALL_FOR_AGENTS.md.

Preguntas rápidas

¿Hace falta saber programar?

No para instalarlo: son dos comandos de copiar y pegar. Pero ai-memory solo sirve si ya usas un agente de código (Claude Code, Codex, Cursor…). El sitio oficial dice: “es una herramienta para quien ya usa IA para trabajar en código”.

¿Es gratis?

ai-memory es gratis y de código abierto (MIT), sin registro y sin clave de API por defecto. Los agentes no: Claude Code y Codex siguen con el plan de cada uno (o API de pago), con el mismo límite y el mismo cobro. La herramienta no amplía tu límite: solo evita empezar de cero cuando cambias.

¿Funciona en mi ordenador? ¿Y en el móvil?

Mac y Linux: sí. Windows: con WSL2 (recomendado); Windows nativo es experimental. Móvil: no, es una herramienta de ordenador.

¿Es seguro?

• El código es abierto (MIT) y el servidor, por defecto, escucha solo en tu ordenador, con una contraseña creada en la instalación. No hay registro, y el proyecto dice que no envía telemetría (DATA_HANDLING.md).
• Pero los disparadores graban tus pedidos. Las contraseñas y claves reconocidas se borran antes de guardar, pero el filtro puede dejar pasar texto sensible (aimemory.sh). No pegues contraseñas ni datos de clientes en el chat.
• No es “100% offline”: la primera vez, el servidor descarga un pequeño modelo de búsqueda (~87 MB) de Hugging Face. Nada de tu contenido va con él (DATA_HANDLING.md). Y lo que envías a Claude o a Codex sigue yendo a ellos, como siempre.
• No hay cifrado en disco en la versión 1: la protección son los permisos de archivos de tu ordenador (DATA_HANDLING.md).
• Es un proyecto activo y que cambia rápido (varias versiones por semana): empieza con un proyecto de prueba.

¿Funciona en español?

Graba lo que escribas, en cualquier idioma. Los comandos y la documentación están en inglés.

Límites honestos

• No hace la IA gratis ni amplía el límite de tu plan.
• No “recuerda todo”: es un traspaso, y la memoria puede llegar incompleta o desactualizada. Revisa las decisiones importantes.
• Más de 20 agentes, no “cualquier agente”.
• El historial completo de Claude solo en el mismo ordenador.
• Terminal obligatoria; en Windows, se recomienda WSL2. No hay app de móvil.
• Puede grabar texto sensible que se escape del filtro.
• Los números (versión, cantidad de agentes) se consultaron el 30/10/2026 y cambian. No probamos la herramienta ni medimos nada.

Créditos y fuente

• Proyecto: ai-memory, de Fabio Akita (“Copyright (c) 2026 Fabio Akita”), licencia MIT. El logo, la imagen de la vista web y INSTALL_FOR_AGENTS.md vienen del repositorio en el commit 8cb9722 (30/10/2026), sin cambios de contenido.
• Por qué lo creó: I Built a Memory System for Coding Agents: ai-memory (blog de Akita, 23/05/2026) y cambiar de agente con ai-memory run (20/07/2026).
• Sobre el autor: akitaonrails.com/about y el canal Akitando.
• Fuente oficial: el sitio aimemory.sh y el código en github.com/akitaonrails/ai-memory.
• Guía de la comunidad en portugués: LinuxPro (cubre la versión 2.6.3, más antigua).
• Esta guía no está afiliada a Fabio Akita, Anthropic ni OpenAI.

El post de Akita explicando por qué creó ai-memory, capturado el 30/10/2026.

Página pública del proyecto en GitHub, capturada el 30/10/2026.