timgordontg/engrim

O que é?

Recursos principais

• 01Compartilha um único armazenamento de memória SQLite local entre vários agentes de programação com IA no mesmo projeto.
• 02Injeta um pacote de memória com tamanho limitado no início da sessão, incluindo um ponteiro para retomar trabalhos inacabados.
• 03Combina busca de texto completo com FTS5 e embeddings vetoriais do model2vec para recuperação híbrida, com opção de usar apenas busca lexical.
• 04Registra qual agente originou cada entrada de memória.
• 05Oferece engrim doctor para verificar a integridade do banco de dados e a configuração dos hooks, com opção de correção automática.
• 06Disponibiliza ferramentas engrim_* por meio de um servidor MCP via stdio e inclui comandos de backup, mesclagem e remoção de registros antigos.

Casos de uso

• Continuar trabalhando em uma base de código no Claude Code ou no Cursor depois de limpar o chat, sem precisar explicar novamente as decisões de arquitetura.
• Alternar entre vários agentes de programação com IA no mesmo repositório mantendo um único registro compartilhado de decisões.
• Manter a memória do projeto local em bases de código nas quais não é aceitável enviar contexto para serviços de memória de terceiros.
• Levar a memória entre execuções de CI mesclando armazenamentos SQLite exportados.

Início rápido

1. 1

   Instalar engrim pelo PyPI

   pip install engrim
2. 2

   Detectar e configurar automaticamente os ambientes de agentes instalados

   engrim setup
3. 3

   Verificar o estado da instalação

   engrim doctor

Antes de usar

• !Requer Python 3.10 ou posterior.
• !A memória é armazenada em um arquivo SQLite local em ~/.engrim/memory.db, sem sincronização na nuvem entre máquinas.
• !Os hooks do Codex CLI devem ser revisados e aprovados manualmente antes de serem executados.

Em coleções

Tópicos

Perguntas frequentes

O que é engrim?

Um mecanismo de memória SQLite local e por projeto que compartilha decisões de código e o estado do projeto entre agentes de programação com IA, como Claude Code, Cursor e Codex CLI. engrim é uma ferramenta Python que oferece aos agentes de programação com IA uma memória compartilhada e persistente para uma base de código. Em vez de reproduzir longas transcrições de chat, ela armazena registros selecionados, como decisões de arquitetura, fatos, restrições e a tarefa atual, em um arquivo SQLite local em ~/.engrim/memory.db. Ao iniciar uma nova sessão, injeta um pacote de memória com tamanho limitado.

engrim é gratuito? Qual é a licença?

engrim é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

engrim ainda é mantido?

Atualizado nos últimos 6 meses. O último commit de engrim foi em 26 de set. de 2026.

Para que posso usar engrim?

Continuar trabalhando em uma base de código no Claude Code ou no Cursor depois de limpar o chat, sem precisar explicar novamente as decisões de arquitetura. Alternar entre vários agentes de programação com IA no mesmo repositório mantendo um único registro compartilhado de decisões. Manter a memória do projeto local em bases de código nas quais não é aceitável enviar contexto para serviços de memória de terceiros. Levar a memória entre execuções de CI mesclando armazenamentos SQLite exportados.

Como instalar engrim?

Instalar engrim pelo PyPI: pip install engrim Detectar e configurar automaticamente os ambientes de agentes instalados: engrim setup Verificar o estado da instalação: engrim doctor

Onde consigo engrim?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/timgordontg/engrim