Você já perdeu uma hora re-explicando pro Claude o que vocês dois fizeram ontem?
Eu já. Várias vezes.
Você está lá, no meio de um refactor complexo, o Claude entendeu toda a arquitetura, tomou decisões inteligentes, corrigiu bugs que você nem sabia que existiam. Aí a sessão cai. Ou você fecha o terminal. Ou simplesmente vai dormir.
No dia seguinte? Tábula rasa. O Claude não faz ideia do que aconteceu. Você precisa explicar tudo de novo. A arquitetura, as decisões, os bugs, o contexto do cliente.
Isso não é um bug. É uma limitação fundamental de como coding agents funcionam. Sessões são efêmeras. Contexto morre quando a sessão morre.
Até agora.
O que é o claude-mem
claude-mem é um plugin open-source que dá memória persistente ao Claude Code. Criado por Alex Newman (@thedotmack), o projeto já tem 43.936 stars no GitHub, 174 releases em 7 meses, e mais de 1.500 commits.
A premissa é simples: o plugin captura automaticamente TUDO que o Claude faz durante uma sessão de coding (edições de arquivo, comandos executados, decisões arquiteturais, bugs corrigidos) comprime essa informação usando IA, e injeta o contexto relevante na próxima sessão.
Você não precisa fazer nada. Não precisa escrever documentação. Não precisa lembrar de salvar notas. O claude-mem faz isso sozinho.
O problema que ele resolve (e por que isso importa pra você)
O Claude Code nativo tem o CLAUDE.md e o MEMORY.md. Funciona? Funciona. Pra projetos pequenos. Mas o MEMORY.md tem limite de 200 linhas. E é baseado em texto simples, sem busca semântica, sem priorização, sem contexto temporal.
Agora imagina sua software house com 5, 10, 20 projetos rodando ao mesmo tempo. Cada dev usando Claude Code 8 horas por dia. São centenas de sessões por semana, milhares de decisões, centenas de bugs corrigidos.
200 linhas não seguram isso.
O claude-mem resolve com uma arquitetura de 3 camadas que é, na minha opinião, elegante:
- Layer 1 — Search: Resultados indexados e compactos (~50-100 tokens)
- Layer 2 — Timeline: Contexto cronológico ao redor dos resultados
- Layer 3 — Get Observations: Detalhes completos só para o que importa (~500-1.000 tokens)
O resultado? ~10x de economia em tokens. O sistema filtra antes de buscar os detalhes. Isso significa que o Claude recebe apenas o contexto que precisa, quando precisa.
Como funciona por baixo do capô
O claude-mem opera com 5 lifecycle hooks que se integram ao Claude Code:
- SessionStart — Carrega contexto relevante das sessões anteriores
- UserPromptSubmit — Monitora o que você está pedindo
- PostToolUse — Captura cada ação do Claude (file edit, bash, grep, tudo)
- Stop — Gera um summary comprimido da sessão
- SessionEnd — Persiste tudo no banco de dados
Por trás, roda um Worker Service em Bun na porta 37777, um banco SQLite para persistência, e um Chroma Vector Database para busca híbrida (semântica + keyword). Tem até uma interface web pra você visualizar o stream de memória em tempo real.
A instalação? Duas linhas:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-memDone. A partir daí, toda sessão é automaticamente capturada.
Os números que me chamaram atenção
Na minha experiência com 300+ software houses, eu aprendi a prestar atenção nos números que contam a história real de um projeto:
- 43.936 stars em 7 meses — crescimento orgânico, sem hype artificial
- 174 releases — praticamente um release por dia. Esse nível de iteração é raro em open-source
- 1.500+ commits no branch principal — código ativo, não abandonware
- 22+ contributors — comunidade real contribuindo
- 3.300 forks — gente usando de verdade, adaptando pra suas necessidades
- 30+ idiomas de README — incluindo português brasileiro
- 100% local — seus dados nunca saem da sua máquina
Esse último ponto é crítico. Numa época em que todo mundo quer mandar seus dados pra cloud, o claude-mem roda inteiramente local. SQLite. Na sua máquina. Ponto.
claude-mem vs a concorrência
| Claude Nativo | claude-mem | Supermemory | |
|---|---|---|---|
| Preço | Grátis | Grátis | Pago |
| Privacidade | Local | 100% Local | Cloud |
| Escala | 200 linhas | Ilimitado | Ilimitado |
| Automação | Manual | Automático | Automático |
| Busca | Nenhuma | Semântica + keyword | Semântica |
O claude-mem não substitui o CLAUDE.md nativo — ele complementa. Você continua usando suas instruções manuais, mas agora tem uma camada de memória automática ilimitada por baixo.
Como usar na sua software house
Aqui é onde fica prático. Alguns cenários que eu vejo como transformadores:
1. Continuidade de projetos
Dev para às 18h, volta às 9h. O Claude lembra de tudo. Não precisa de handoff manual, não precisa de daily pra explicar onde parou.
2. Onboarding acelerado
Dev novo entra no projeto. O claude-mem já tem o histórico de todas as decisões arquiteturais, bugs corrigidos, padrões adotados. É como ter um mentor que lembra de cada commit.
3. Documentação automática
Cada sessão é registrada. Você ganha uma auditoria gratuita de todas as mudanças. Quando o cliente perguntar “por que vocês mudaram o banco de dados?”, a resposta está lá.
4. Economia de tokens
Com progressive disclosure, você gasta ~10x menos tokens em contexto. Pra quem roda Claude Code em escala, isso é dinheiro real.
5. Privacidade por padrão
O plugin tem tags <private> pra excluir conteúdo sensível do armazenamento. Código de cliente, credenciais, dados sigilosos — tudo protegido.
O que eu penso
Na minha experiência mentorando 300+ software houses, o maior gargalo que eu vejo com coding agents não é a qualidade do código gerado. É a perda de contexto.
Times inteiros gastam horas por semana re-explicando contexto pra IA. É como ter um estagiário brilhante que perde a memória todo dia. O claude-mem transforma esse estagiário num sênior com memória fotográfica.
O que me impressiona é a velocidade de iteração. 174 releases em 7 meses mostra um criador obcecado com o produto. E o fato de ser AGPL-3.0 (open-source real, não “open-source mas só se você não competir comigo”) mostra maturidade.
O único ponto de atenção? A licença AGPL exige que, se você modificar e distribuir, precisa abrir o código. Pra uso interno na software house, zero problema. Mas se você pensar em embeddar num produto SaaS, preste atenção nos termos.
De resto? É plug and play. Dois comandos e você tem memória infinita.
Conclusão
O claude-mem não é mais uma ferramenta “nice to have”. Pra quem usa Claude Code no dia a dia — e se a sua software house não está usando, a gente precisa conversar — memória persistente é infraestrutura básica.
É a diferença entre um agente que te ajuda e um agente que evolui junto com o seu projeto.
43.936 developers já entenderam isso. A pergunta é: você vai continuar re-explicando contexto pro Claude todo dia, ou vai resolver isso em 2 comandos?
Sou Thulio, mentoro 300+ SHs desde 2016.
