Repolode
thedotmack

thedotmack/claude-mem

Memória persistente para agentes de programação: registra a atividade das sessões, compacta as informações com IA e injeta contexto relevante em sessões futuras.

Estrelas
101,763
Forks
8,950
Issues abertas
92
Último commit
há 22 horas

O que é?

Claude-Mem é uma camada de memória para agentes de programação com IA. Registra o uso de ferramentas e as observações de cada sessão, gera resumos semânticos compactos com um modelo de IA e os disponibiliza quando uma sessão posterior é iniciada, para que o agente mantenha o contexto do projeto mesmo depois que uma sessão termina ou é retomada.

A solução se baseia em hooks de ciclo de vida do Claude Code, com instaladores para outros ambientes, como OpenCode, Codex, OpenClaw e T3 Code. Um serviço local de worker disponibiliza uma API HTTP e um visualizador web, e armazena os dados no SQLite com busca FTS5. O Chroma oferece busca vetorial, permitindo combinar correspondências semânticas e por palavras-chave.

Os agentes consultam a memória por meio de quatro ferramentas MCP, seguindo um fluxo em três etapas: um índice de busca compacto, uma linha do tempo em torno dos resultados correspondentes e, por fim, os detalhes completos apenas dos IDs selecionados. O conteúdo delimitado por tags privadas é excluído do armazenamento, e uma configuração de modo controla o estilo do fluxo de trabalho e o idioma das observações geradas.

Recursos principais

  • 01Registra automaticamente o uso de ferramentas e as observações das sessões por meio de hooks de ciclo de vida.
  • 02Compacta a atividade das sessões em resumos semânticos usando um modelo de IA.
  • 03Injeta contexto relevante de sessões anteriores no início de novas sessões.
  • 04Oferece ferramentas de busca MCP com um fluxo de recuperação em três etapas que economiza tokens.
  • 05Combina a busca de texto completo do SQLite com a busca vetorial do Chroma.
  • 06Inclui um visualizador web local e uma API HTTP para consultar a memória.

Casos de uso

  • Manter o contexto do projeto ao longo de várias sessões do Claude Code em uma base de código de longa duração.
  • Permitir que um agente recupere correções de bugs e decisões de design anteriores sem reler transcrições completas.
  • Pesquisar trabalhos anteriores do agente por palavra-chave, tipo ou data usando ferramentas MCP.

Início rápido

  1. 1

    Instale o plugin com um único comando

    npx claude-mem install
  2. 2

    Entre no claude-mem pelo navegador (usando um link mágico enviado por e-mail) ou escolha um provedor

  3. 3

    Reinicie o Claude Code; o contexto das sessões anteriores aparecerá nas novas sessões

Antes de usar

  • Ao entrar, você desbloqueia um teste grátis de 30 dias do claude-mem observer; depois, a memória volta a usar seu plano da Anthropic, a menos que você assine.
  • O pacote npm instala apenas o SDK/biblioteca. Para obter os hooks e o serviço worker, use o instalador npx ou os comandos /plugin.
  • É necessário ter o Node.js 20 ou posterior.

Tópicos

Perguntas frequentes

O que é claude-mem?
Memória persistente para agentes de programação: registra a atividade das sessões, compacta as informações com IA e injeta contexto relevante em sessões futuras. Claude-Mem é uma camada de memória para agentes de programação com IA. Registra o uso de ferramentas e as observações de cada sessão, gera resumos semânticos compactos com um modelo de IA e os disponibiliza quando uma sessão posterior é iniciada, para que o agente mantenha o contexto do projeto mesmo depois que uma sessão termina ou é retomada.
claude-mem é gratuito? Qual é a licença?
claude-mem é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
claude-mem ainda é mantido?
Manutenção ativa. O último commit de claude-mem foi em 19 de out. de 2026.
Para que posso usar claude-mem?
Manter o contexto do projeto ao longo de várias sessões do Claude Code em uma base de código de longa duração. Permitir que um agente recupere correções de bugs e decisões de design anteriores sem reler transcrições completas. Pesquisar trabalhos anteriores do agente por palavra-chave, tipo ou data usando ferramentas MCP.
Como instalar claude-mem?
Instale o plugin com um único comando: npx claude-mem install Entre no claude-mem pelo navegador (usando um link mágico enviado por e-mail) ou escolha um provedor Reinicie o Claude Code; o contexto das sessões anteriores aparecerá nas novas sessões
Onde consigo claude-mem?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/thedotmack/claude-mem

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados