O que é o MemoryCustodian?
O MemoryCustodian é uma ferramenta open-source e local-first que oferece aos agentes de codificação — como Codex, Claude Code e Gemini — uma memória de projeto durável, sem exigir um serviço hospedado ou sobrecarregar cada prompt. Ele armazena decisões, restrições, abordagens rejeitadas e contexto do projeto como arquivos Markdown simples diretamente no seu repositório. Um sistema de manifesto carrega apenas a memória relevante para cada tarefa, mantendo as sessões dos agentes focadas e eficientes. O MemoryCustodian foi projetado para ser revisado, versionado, compartilhado e excluÃdo como código, tornando-se uma opção natural para qualquer fluxo de trabalho de desenvolvimento.
Para quem é
- Desenvolvedores individuais que desejam que seus agentes de codificação lembrem do contexto do projeto entre sessões, sem precisar colar instruções manualmente em cada prompt.
- Equipes que colaboram com agentes de IA que precisam de uma memória de projeto compartilhada e versionada, à qual todos — humanos e agentes — possam acessar e atualizar.
- Mantenedores de projetos open-source que preferem soluções local-first e auto-hospedadas e desejam evitar dependência de fornecedores ou custos recorrentes de serviço para memória de agentes.
Principais recursos
Armazenamento em Markdown simples
A memória é armazenada como arquivos Markdown padrão no seu repositório, permitindo que humanos revisem, editem e versionem como se fosse código. Sem formatos proprietários, sem bancos de dados externos — apenas arquivos que funcionam com seu fluxo de trabalho Git existente.
Carregamento de contexto orientado por manifesto
Um arquivo manifest.md direciona o agente apenas para os arquivos de memória relevantes para a tarefa atual. Em vez de carregar tudo, o agente lê brief.md para a estrutura do projeto, decisions.md e constraints.md para planejamento, e do-not-use.md para evitar caminhos rejeitados — mantendo o contexto mÃnimo e focado.
Compatibilidade entre agentes
O MemoryCustodian funciona com Codex, Claude Code, Gemini e outros agentes de codificação. Um único comando init cria arquivos de inicialização para o agente escolhido, e a mesma estrutura de memória funciona em diferentes ferramentas e plataformas.
Memória com escopo e opcional
Diretórios opcionais como rules/, profiles/, areas/ e archive/ ficam fora do contexto padrão até que sejam explicitamente relevantes. Isso evita o inchaço da memória e garante que os agentes carreguem apenas o necessário para a tarefa em questão.
O que se destaca
"Memória durável. Contexto mÃnimo."
Esta frase resume a filosofia central do MemoryCustodian: ele fornece aos agentes conhecimento duradouro do projeto sem inflar cada prompt. Ao armazenar a memória como Markdown simples no repositório e carregar apenas o necessário por tarefa, ele evita a troca comum entre profundidade de memória e eficiência de prompt. O resultado é um sistema que parece invisÃvel — os agentes lembram do que importa, e você nunca paga por contexto que não usa.
Vale a pena conferir se…
Você está cansado de repetir o mesmo contexto de projeto para seus agentes de codificação a cada sessão, ou se deseja uma alternativa leve e open-source aos serviços de memória hospedados. O MemoryCustodian é especialmente útil se você valoriza ferramentas local-first, conhecimento de projeto versionado e a capacidade de revisar e selecionar o que seus agentes lembram. É uma opção prática para qualquer equipe ou desenvolvedor individual que usa assistentes de codificação com IA e deseja uma memória de projeto durável, mÃnima e compartilhável.
