Repolode
timgordontg

timgordontg/engrim

Motor de memoria SQLite local y por proyecto que comparte decisiones de desarrollo y estado del proyecto entre agentes de programación con IA como Claude Code, Cursor y Codex CLI.

Estrellas
304
Forks
16
Issues abiertos
4
Último commit
el mes pasado

¿Qué es?

engrim es una herramienta de Python que proporciona a los agentes de programación con IA una memoria compartida y persistente para una base de código. En lugar de repetir largas transcripciones de chat, guarda registros seleccionados —como decisiones de arquitectura, datos, restricciones y la tarea actual— en un archivo SQLite local en ~/.engrim/memory.db y, al iniciar una sesión nueva, incorpora un paquete de memoria con un tamaño limitado.

Se integra con Google Antigravity, Claude Code, Cursor, Windsurf, Codex CLI, GitHub Copilot CLI y OpenCode. Usa hooks del ciclo de vida cuando el agente los admite y, en caso contrario, un servidor MCP (engrim serve --mcp). Los registros llevan una etiqueta con el agente que los creó, y la recuperación combina la búsqueda de texto completo de FTS5 con embeddings vectoriales estáticos de model2vec; estos últimos se pueden desactivar para usar solo búsqueda léxica. El motor también incluye una comprobación del estado (engrim doctor) que verifica la integridad de la base de datos y la configuración de los hooks, además de comandos CLI para hacer copias de seguridad, combinar y depurar registros.

Todos los datos permanecen en el equipo local, sin telemetría ni sincronización con la nube, y la base de datos se crea con permisos exclusivos para el propietario.

Funciones clave

  • 01Comparte un almacén de memoria SQLite local entre varios agentes de programación con IA en un mismo proyecto.
  • 02Incorpora al inicio de la sesión un paquete de memoria de tamaño limitado, con un indicador para retomar el trabajo sin terminar.
  • 03Combina la búsqueda de texto completo de FTS5 con embeddings vectoriales de model2vec; también permite usar solo búsqueda léxica.
  • 04Registra qué agente originó cada entrada de memoria.
  • 05Incluye engrim doctor para comprobar la integridad de la base de datos y la configuración de los hooks, con una opción de reparación automática.
  • 06Expone herramientas engrim_* mediante un servidor MCP por stdio e incluye comandos para hacer copias de seguridad, combinar y depurar registros.

Casos de uso

  • Retomar el trabajo en una base de código con Claude Code o Cursor después de borrar el chat, sin tener que volver a explicar las decisiones de arquitectura.
  • Alternar entre varios agentes de programación con IA en el mismo repositorio y conservar un único registro compartido de decisiones.
  • Mantener local la memoria del proyecto en bases de código cuyo contexto no se puede enviar a servicios de memoria de terceros.
  • Conservar la memoria entre ejecuciones de CI mediante la combinación de almacenes SQLite exportados.

Inicio rápido

  1. 1

    Instalar engrim desde PyPI

    pip install engrim
  2. 2

    Detectar y configurar automáticamente los entornos de agentes instalados

    engrim setup
  3. 3

    Comprobar el estado de la instalación

    engrim doctor

Antes de usarlo

  • Requiere Python 3.10 o posterior.
  • La memoria se guarda en un archivo SQLite local en ~/.engrim/memory.db, sin sincronización en la nube entre máquinas.
  • Los hooks de Codex CLI deben revisarse y aprobarse manualmente antes de ejecutarse.

En colecciones

Temas

Preguntas frecuentes

¿Qué es engrim?
Motor de memoria SQLite local y por proyecto que comparte decisiones de desarrollo y estado del proyecto entre agentes de programación con IA como Claude Code, Cursor y Codex CLI. engrim es una herramienta de Python que proporciona a los agentes de programación con IA una memoria compartida y persistente para una base de código. En lugar de repetir largas transcripciones de chat, guarda registros seleccionados —como decisiones de arquitectura, datos, restricciones y la tarea actual— en un archivo SQLite local en ~/.engrim/memory.db y, al iniciar una sesión nueva, incorpora un paquete de memoria con un tamaño limitado.
¿engrim es gratuito? ¿Qué licencia tiene?
engrim es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿engrim sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de engrim fue el 26 sept 2026.
¿Para qué puedo usar engrim?
Retomar el trabajo en una base de código con Claude Code o Cursor después de borrar el chat, sin tener que volver a explicar las decisiones de arquitectura. Alternar entre varios agentes de programación con IA en el mismo repositorio y conservar un único registro compartido de decisiones. Mantener local la memoria del proyecto en bases de código cuyo contexto no se puede enviar a servicios de memoria de terceros. Conservar la memoria entre ejecuciones de CI mediante la combinación de almacenes SQLite exportados.
¿Cómo se instala engrim?
Instalar engrim desde PyPI: pip install engrim Detectar y configurar automáticamente los entornos de agentes instalados: engrim setup Comprobar el estado de la instalación: engrim doctor
¿Dónde consigo engrim?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/timgordontg/engrim

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

Proyectos relacionados