Repolode
Enviar
tigerless-labs

tigerless-labs/agent-memory

Runtime de memoria a largo plazo para agentes de IA que guarda recuerdos en Markdown sin formato, clasifica las consultas localmente y comparte un almacén entre Claude Code, Codex CLI y otros agentes con acceso a la shell.

Ver en GitHub
Estrellas
4,310
Forks
204
Issues abiertos
9
Último commit
hace 15 horas

¿Qué es?

agent-memory proporciona a los agentes de IA una memoria que persiste al terminar una sesión. Los recuerdos se guardan como archivos Markdown en un único directorio, y el índice SQLite que los acompaña es una caché que se puede reconstruir, por lo que eliminarlo no hace perder información. Claude Code, Codex CLI, Muse Code y cualquier herramienta capaz de ejecutar un comando de shell leen y escriben en el mismo almacén.

La recuperación es local y clasificada por relevancia. Devuelve una lista de resúmenes de una línea con las rutas de los archivos, y el agente abre cada resultado con el nivel de detalle que necesite la tarea: desde el esquema hasta el archivo completo y los mensajes originales de la sesión citados. Las escrituras se activan en límites de conversación, como al detener una sesión o al compactarla, y un proceso independiente durante el tiempo de inactividad consolida los recuerdos y propone eliminaciones para que el usuario las confirme. Los recuerdos reemplazados se conservan, y la recuperación puede responder según una fecha determinada.

La biblioteca no incluye un cliente LLM; delega la toma de decisiones en el propio CLI del agente anfitrión. Como extras opcionales, ofrece búsqueda vectorial mediante FastEmbed y tokenización CJK mediante jieba.

Funciones clave

  • 01Los archivos Markdown son la fuente de verdad; el índice SQLite se puede eliminar y reconstruir.
  • 02Recuperación BM25 local, con fusión vectorial opcional mediante fusión de rangos recíprocos.
  • 03Lectura por niveles: desde el resumen hasta el esquema, el archivo completo y los mensajes originales citados.
  • 04Escrituras automáticas en los límites de sesión, con consolidación durante el tiempo de inactividad que requiere confirmación para las eliminaciones.
  • 05Almacén compartido entre Claude Code, Codex CLI y Muse Code, además de la opción de usar un servidor MCP.
  • 06Recuperación en un momento determinado, conservando los recuerdos reemplazados en la cadena.

Casos de uso

  • Conservar las decisiones de un proyecto entre sesiones distintas de un agente de programación.
  • Compartir un almacén de memoria entre varios entornos anfitriones de agentes en la misma máquina.
  • Guardar la memoria del agente en archivos fáciles de buscar con grep, versionables con Git y portables fuera de la herramienta.
  • Añadir recuperación en chino a la memoria de un agente mediante el tokenizador CJK opcional.

Inicio rápido

  1. 1

    Clona el repositorio

    git clone https://github.com/tigerless-labs/agent-memory.git
  2. 2

    Instala las dependencias desde el checkout con uv

    uv sync --all-packages
  3. 3

    Inicializa el almacén de memoria

    mem init
  4. 4

    Intégralo en Claude Code

    mem setup --host claude-code

Antes de usarlo

  • Todavía no hay una versión en PyPI, así que la instalación requiere un checkout del código fuente.
  • Se requiere Python 3.12 o posterior y uv.
  • La versión 0.1.0 está en una fase inicial, y la configuración de Codex CLI puede requerir aprobaciones adicionales del entorno aislado o de confianza.

En colecciones

Memoria a largo plazo para agentes de IAHerramientas, skills y plugins para Claude CodeFrameworks y apps de agentes de IA open sourceAsistentes y agentes de programación con IAServidores MCPHerramientas de privacidad y local-firstBases de datos y herramientas SQLGeneradores de sitios estáticos y herramientas de documentación

Temas

#agent-memory#ai-agents#long-term-memory#markdown#local-first#retrieval#sqlite#mcp#claude-code#codex

Preguntas frecuentes

¿Qué es agent-memory?
Runtime de memoria a largo plazo para agentes de IA que guarda recuerdos en Markdown sin formato, clasifica las consultas localmente y comparte un almacén entre Claude Code, Codex CLI y otros agentes con acceso a la shell. agent-memory proporciona a los agentes de IA una memoria que persiste al terminar una sesión. Los recuerdos se guardan como archivos Markdown en un único directorio, y el índice SQLite que los acompaña es una caché que se puede reconstruir, por lo que eliminarlo no hace perder información. Claude Code, Codex CLI, Muse Code y cualquier herramienta capaz de ejecutar un comando de shell leen y escriben en el mismo almacén.
¿agent-memory es gratuito? ¿Qué licencia tiene?
agent-memory es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿agent-memory sigue mantenido?
Mantenimiento activo. El último commit de agent-memory fue el 6 nov 2026.
¿Para qué puedo usar agent-memory?
Conservar las decisiones de un proyecto entre sesiones distintas de un agente de programación. Compartir un almacén de memoria entre varios entornos anfitriones de agentes en la misma máquina. Guardar la memoria del agente en archivos fáciles de buscar con grep, versionables con Git y portables fuera de la herramienta. Añadir recuperación en chino a la memoria de un agente mediante el tokenizador CJK opcional.
¿Cómo se instala agent-memory?
Clona el repositorio: git clone https://github.com/tigerless-labs/agent-memory.git Instala las dependencias desde el checkout con uv: uv sync --all-packages Inicializa el almacén de memoria: mem init Intégralo en Claude Code: mem setup --host claude-code
¿Dónde consigo agent-memory?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/tigerless-labs/agent-memory

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados