A quién le sirve. Programadores que usan Claude Code, Cursor o Codex y quieren que las decisiones del proyecto sobrevivan de una sesión a otra, guardadas en el repositorio (la carpeta del proyecto con su historial de cambios).
Qué hicieron
Se compila un programa en Go y se ejecuta un comando de arranque en el proyecto. Crea una carpeta knowledge/ con archivos Markdown con cabecera YAML, una habilidad para el agente y un AGENTS.md. Los agentes llegan a la memoria por línea de comandos o por un servidor MCP (un estándar para conectar herramientas a agentes), compatible con Claude Code, Cursor y Codex. La norma les dice que busquen antes de escribir y que carguen solo las páginas de índice que necesiten.
Cómo salió
El README afirma búsquedas de menos de 300 µs, unos 4 ms para validar más de 50 conceptos y un 80 % menos de tokens (las unidades de texto que consume la IA). Esas cifras salen de las propias pruebas y de la tabla comparativa del proyecto, sin resultados independientes.
Conviene saber
El repositorio es nuevo: un solo cambio guardado y 3 estrellas. El dato del 80 % viene de una prueba que puedes repetir con make benchmark usando un modelo local.
Qué necesitas
- Un repositorio de código con git
- Un agente de programación: Claude Code, Cursor o Codex
- Go, el lenguaje de programación en que está hecha, instalado para compilar la herramienta del caso
- El código de la herramienta (okf-agent-memory), que enlaza la ficha
- Un proyecto de prueba donde no te importe equivocarte
Cómo hacerlo tú, paso a paso
- Compila el programa de la herramienta, que está hecho en Go, siguiendo las instrucciones de su página de GitHub.
- En la carpeta de tu proyecto, ejecuta su comando de arranque. Crea una carpeta knowledge/ con las notas, una habilidad para el agente y un archivo AGENTS.md con las normas.
- Conecta la memoria a tu agente desde la terminal o por su servidor MCP (el estándar que permite al agente usar herramientas externas).
- Pide al agente que lea las normas y que busque en la memoria antes de escribir nada nuevo.
- Al terminar cada sesión, pídele que anote decisiones, convenciones y tareas abiertas.
- Revisa en git los cambios de la carpeta antes de guardarlos, como cualquier otro cambio.
- Si quieres comprobar el ahorro que promete la herramienta, repite su prueba (make benchmark) con un modelo local.
Configura una memoria permanente para agentes de programación en este repositorio, guardando notas en una carpeta [nombre de la carpeta, por ejemplo .agent-memory] controlada por git. Crea un formato sencillo para anotar decisiones, convenciones y tareas abiertas, y añade instrucciones para que las sesiones futuras lo lean primero y lo actualicen al final. Habrás terminado cuando me hayas enseñado los archivos que piensas guardar. No hagas ningún commit antes de enseñármelos.
Consejos
- Es un proyecto nuevo y con pocos usuarios. Pruébalo primero en un repositorio sin importancia.
- No guardes contraseñas ni claves en la memoria: se quedarían en el historial de git.
- Las cifras de velocidad y ahorro son del propio proyecto. Repite la prueba antes de fiarte.
Preguntas frecuentes
¿Puedo hacerlo sin instalar nada?
Sí, en versión sencilla: pide al agente que cree una carpeta de notas en tu repositorio, que la lea al empezar y la actualice al terminar, como en el prompt de la ficha. Pierdes la búsqueda y la validación que añade la herramienta.
¿Para qué sirve guardar la memoria en git?
Para que viaje con el proyecto. Quien lo clone, y cualquier agente, ve las mismas decisiones, y puedes revisar o deshacer cambios igual que en el código.
Fuentes
En el directorio desde el 3 de octubre de 2026.