claude-mem guarda o que o seu agente esquece, com ressalvas

Todo agente de programação tem o mesmo hábito embaraçoso. Passa-se uma tarde a explicar porque é que o middleware de autenticação não pode ser tocado, onde vive a configuração antiga e quais são os dois testes que falham de propósito. Depois fecha-se o portátil. Na manhã seguinte, o agente cumprimenta como se fosse um desconhecido e sugere, muito animado, refatorar exatamente o ficheiro que lhe pediram para deixar em paz.
É esse buraco que o claude-mem tenta tapar, e os números dizem que muita gente o sente. O repositório ronda as 110 mil estrelas, ganhou cerca de 5.850 na última semana e há dias que está no topo da lista de tendências semanais do GitHub. O projeto de Alex Newman descreve-se como um «sistema de compressão de memória persistente» para o Claude Code, e a palavra-chave é compressão, não armazenamento.
O que fica realmente guardado
O mecanismo é menos mágico do que o pitch. O claude-mem regista-se nos hooks de ciclo de vida que o Claude Code já expõe: SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop, SessionEnd. Cada hook é um comando único, claude-mem hook claude-code <event>, executado por um pequeno lançador que o instalador coloca no PATH.
Enquanto se trabalha, as chamadas de ferramentas transformam-se em «observações» — notas semânticas curtas sobre o que o agente fez e o que aconteceu. Um serviço de fundo, gerido pelo Bun, escreve-as numa base SQLite. Quando começa uma sessão nova, as observações mais relevantes são injetadas de volta no contexto antes de se escrever a primeira linha.
Há também uma base vetorial Chroma na pilha para pesquisa semântica, ao lado do FTS5 do SQLite para pesquisa por palavra-chave. Na prática, o híbrido importa: «aquele script de migração de terça-feira» é uma consulta por palavra-chave, «a coisa em que o refresh do token falha em silêncio» é uma consulta semântica, e ambos os tipos vão ser escritos.
Dois detalhes merecem atenção porque mostram que o projeto já foi usado a sério. O primeiro, uma etiqueta <private>: tudo o que estiver lá dentro nunca é guardado. O segundo, as capturas de ecrã são opcionais e vêm desligadas por defeito, e só chegam ao modelo observador se a inferência de imagem estiver ativada à parte. Alguém pensou no cenário em que uma ferramenta de memória se transforma, sem aviso, numa ferramenta de vigilância.

O truque de recuperação em três camadas
A parte que me parece genuinamente bem desenhada é a superfície de pesquisa. Em vez de despejar memórias no contexto e esperar que o modelo se oriente, o claude-mem expõe um fluxo MCP em três passos.
search devolve um índice compacto com IDs, à volta de 50 a 100 tokens por resultado. timeline dá o contexto cronológico em torno de um resultado interessante. get_observations vai buscar o detalhe completo, a 500 ou 1.000 tokens cada, mas só para os IDs que foram realmente escolhidos. O README fala de cerca de 10x de poupança de tokens ao filtrar antes de ir buscar, o que é o tipo certo de alegação: é um argumento contabilístico, não de capacidade.
É a diferença entre um sistema de memória e uma janela de contexto. Uma janela maior é um custo fixo que se paga a cada turno. A revelação progressiva é um custo que só se paga quando se vai procurar. Quem já viu uma sessão longa a queimar tokens com output velho de ferramentas sabe qual dos dois escala.
A instalação é uma linha, e isso é o ponto
O caminho feliz é este:
npx claude-mem install
Funciona com --ide opencode, --ide t3code, --ide pi, --ide antigravity e mais alguns, além de um modo Grok Bot que vigia registos de conversa porque esse anfitrião não tem hooks. Dentro do Claude Code também se pode ir pelo marketplace de plugins:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
É preciso Node 20 ou mais recente. O Bun e o uv são trazidos automaticamente se faltarem. No Windows, o instalador coloca um lançador em %LOCALAPPDATA%\claude-mem\bin e adiciona-o ao PATH do utilizador; se os hooks se queixarem de um executável em falta, npx claude-mem doctor é o ponto de entrada para diagnosticar.
Uma armadilha que vale a pena repetir do README: npm install -g claude-mem instala apenas o SDK. Não regista hooks nem configura o worker, portanto não acontece nada e conclui-se, erradamente, que a ferramenta está avariada.
A parte que me deixa desconfortável
Durante a instalação, é pedido um início de sessão por link mágico enviado por email, sem cartão. Entrar cria uma chave de memória e desbloqueia um observador alojado com 30 dias de experiência; quando a experiência acaba, a memória volta ao plano da Anthropic, a menos que se subscreva. É possível saltar tudo isto com --provider, com CLAUDE_MEM_ONLINE_OPTIN=false ou a correr em CI. Até aqui, tudo bem.
Depois, perto do fim do README, há uma secção chamada «What About CMEM?» que explica que o CMEM é um token criado por terceiros e «oficialmente abraçado» pelo autor do projeto, com direito a endereço de contrato.
Não acho que isso torne o software mau. O código é Apache-2.0, a arquitetura está documentada e a escolha de licença é justificada explicitamente como uma aposta em memória durável dentro das ferramentas de programação. Mas um sistema de memória que sai com uma memecoin e pede um início de sessão antes de começar a lembrar-se está a pedir um tipo específico de confiança, e essa decisão deve ser tomada antes de o apontar para um repositório privado. O caminho apenas local existe. Use-o de propósito, não por acidente.
A memória torna os agentes melhores?
A resposta honesta é: torna-os menos repetitivos. Não é a mesma coisa. Uma observação guardada é uma afirmação sobre o passado, e a base de código provavelmente já mudou desde então. Se o contexto injetado diz «a migração está em db/legacy.ts» e alguém partiu esse ficheiro há três semanas, o agente não ganhou conhecimento, ganhou confiança num facto caducado.
O enquadramento do próprio claude-mem ajuda: as observações são citadas por ID e podem ser inspecionadas no visualizador local, no URL do worker. Trate-as como notas, não como verdade. Os projetos que vão tirar valor disto são os que podam, não os que só acumulam.
Há ainda um efeito de segunda ordem, e é esse que eu vigiaria. A memória muda aquilo que um agente está disposto a fazer sem perguntar. Um agente com histórico avança alegremente com base em pressupostos herdados da semana passada. É um ganho de produtividade até ao momento em que se torna um mal-entendido muito caro.
Para quem faz sentido
Se as suas sessões com agentes são curtas e autossuficientes, ignore. A sobrecarga não compensa, e um contexto limpo é uma funcionalidade.
Se trabalha há vários dias no mesmo repositório, se anda sempre a repetir as mesmas decisões de arquitetura ou se tem agentes em paralelo que precisam de saber o que os outros concluíram, esta é a implementação aberta mais completa da ideia neste momento, e a instalação numa linha faz com que a experiência custe dez minutos.
Só convém entrar com a expectativa certa. O claude-mem não dá memória ao seu agente. Dá-lhe um arquivo, uma ferramenta de pesquisa e o hábito de escrever as coisas. Se as notas continuam verdadeiras é, como sempre, problema seu.
Artigos relacionados
Uma planilha comunitária de toques que desliga os anúncios dos Android chineses
Não mexe no sistema, não desbloqueia nada, não faz flash de nada. Só vira os botões que os fabricantes já deixaram à mostra. O preço é uma lista que alguém precisa continuar escrevendo.
GPT Image 2.6 manteve o preço por token e elevou a fatura
O GPT Image 2.6 mantém cada tarifa por token do 2.5 e mesmo assim custa mais por imagem, porque boa parte do trabalho acontece agora nos tokens de saída. Onze dias após o lançamento, a estrutura de preços diz mais que o ranking.
Alguém reconstruiu o IDM por fora e anotou o que não tocou
Uma reimplementação em Rust do Internet Download Manager promete 5 vezes a velocidade e 86 idiomas. O documento mais interessante é o parágrafo que explica como ela foi feita sem copiar nada.
Rune é um framework de UI em Rust feito para que um agente possa verificar o próprio trabalho
Rune renderiza sem interface, despeja sua árvore de elementos e aceita entrada roteirizada, o que dá a um agente de código um sinal diffável que um screenshot nunca oferece. O framework está em pré-lançamento e não aceita pull requests.