Claude-Mem
thedotmack/claude-mem
Memória persistente comprimida para agentes IA entre sessões
Ver no GitHubSistema de memória persistente que captura o contexto completo de sessões de agentes e IA, comprime com algoritmos inteligentes e injeta informações relevantes em futuras interações. Funciona com Claude Code, OpenAI Codex, Google Gemini e outros modelos populares.
Instalação
npx convez-ai thedotmack/claude-mem1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Manter contexto de projetos longos em Claude Code sem repetir explicações
- Agentes IA que aprendem histórico de interações anteriores
- Reduzir tokens gastos ao reutilizar contexto comprimido de sessões passadas
Veredito

Skill robusto e bem-mantido que resolve um problema real: manter contexto persistente entre sessões de agentes. Implementação madura com suporte a múltiplos modelos, embora exija configuração técnica e compreensão de compressão de contexto.
README em português
Início Rápido
Instale com um único comando:
npx claude-mem install
Ou instale para o Gemini CLI (detecta automaticamente ~/.gemini):
npx claude-mem install --ide gemini-cli
Ou instale para OpenCode:
npx claude-mem install --ide opencode
Ou instale diretamente da loja de plugins dentro do Claude Code:
/plugin marketplace add thedotmack/claude-mem
/plugin install claude-mem
Reinicie o Claude Code ou o Gemini CLI. O contexto das sessões anteriores aparecerá automaticamente nas novas sessões.
Nota: O Claude-Mem também é publicado no npm, mas
npm install -g claude-meminstala apenas a SDK/biblioteca — ele não registra os hooks do plugin nem configura o serviço de worker. Sempre instale vianpx claude-mem installou os comandos/pluginacima.
🦞 OpenClaw Gateway
Instale o claudemem como um plugin de memória persistente em gateways OpenClaw com um único comando:
curl -fsSL https://install.cmem.ai/openclaw.sh | bash
O instalador gerencia dependências, configuração do plugin, provedor de IA, inicialização do worker e feeds de observação em tempo real opcionais para Telegram, Discord, Slack e muito mais. Veja o Guia de Integração OpenClaw para detalhes.
Principais Funcionalidades:
- 🧠 Memória Persistente - O contexto sobrevive entre sessões
- 📊 Revelação Progressiva - Recuperação de memória em camadas com visibilidade do custo de tokens
- 🔍 Busca Baseada em Habilidades - Consulte o histórico do seu projeto usando a habilidade mem-search
- 🖥️ Interface Web Viewer - Fluxo de memória em tempo real no http://localhost:37777
- 💻 Habilidade Claude Desktop - Busque na memória das conversas do Claude Desktop
- 🔒 Controle de Privacidade - Use tags
<private>para excluir conteúdo sensível da armazenamento - ⚙️ Configuração de Contexto - Controle granular sobre o que é injetado no contexto
- 🤖 Operação Automática - Sem necessidade de intervenção manual
- 🔗 Citações - Referencie observações passadas com IDs (acesso via http://localhost:37777/api/observation/{id} ou visualize todas na interface web em http://localhost:37777)
- 🧪 Canal Beta - Experimente funcionalidades experimentais como o Modo Infinito através da troca de versão
Documentação
📚 Ver Documentação Completa - Navegue no site oficial
Primeiros Passos
- Guia de Instalação - Início rápido e instalação avançada
- Configuração do Gemini CLI - Guia dedicado para integração com o Gemini CLI da Google
- Guia de Uso - Como o Claude-Mem funciona automaticamente
- Ferramentas de Busca - Consulte o histórico do seu projeto com linguagem natural
- Funcionalidades Beta - Experimente funcionalidades experimentais como o Modo Infinito
Melhores Práticas
- Engenharia de Contexto - Princípios de otimização do contexto para agentes de IA
- Revelação Progressiva - A filosofia por trás da estratégia de priming de contexto do Claude-Mem
Arquitetura
- Visão Geral - Componentes do sistema e fluxo de dados
- Evolução da Arquitetura - A jornada da v3 para a v5
- Arquitetura de Hooks - Como o Claude-Mem usa hooks do ciclo de vida
- Referência de Hooks - 7 scripts de hook explicados
- Serviço Worker - API HTTP e gerenciamento com Bun
- Banco de Dados - Esquema SQLite & busca FTS5
- Arquitetura de Busca - Busca híbrida com banco vetorial Chroma
Configuração e Desenvolvimento
- Configuração - Variáveis de ambiente & configurações
- Desenvolvimento - Construção, testes, contribuição
- Solução de Problemas - Problemas comuns e soluções
Como Funciona
Componentes Principais:
- 5 Hooks do Ciclo de Vida - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripts de hook)
- Instalação Inteligente - Verificador de dependências em cache (script pré-hook, não um hook do ciclo de vida)
- Serviço Worker - API HTTP na porta 37777 com interface web viewer e 10 endpoints de busca, gerenciado pelo Bun
- Banco de Dados SQLite - Armazena sessões, observações e resumos
- Habilidade mem-search - Consultas em linguagem natural com revelação progressiva
- Banco Vetorial Chroma - Busca híbrida semântica + por palavras-chave para recuperação inteligente de contexto
Veja Visão Geral da Arquitetura para detalhes.
Ferramentas de Busca MCP
O Claude-Mem oferece busca inteligente na memória através de 4 ferramentas MCP seguindo um padrão de fluxo de trabalho em 3 camadas eficiente quanto a tokens:
O Fluxo de Trabalho em 3 Camadas:
search- Obtém índice compacto com IDs (~50-100 tokens/result)timeline- Obtém contexto cronológico ao redor dos resultados interessantesget_observations- Busca detalhes completos APENAS para IDs filtrados (~500-1,000 tokens/result)
Como Funciona:
- O Claude usa ferramentas MCP para buscar sua memória
- Comece com
searchpara obter um índice de resultados - Use
timelinepara ver o que estava acontecendo ao redor de observações específicas - Use
get_observationspara buscar detalhes completos dos IDs relevantes - ~10x economia de tokens filtrando antes de buscar os detalhes
Ferramentas MCP Disponíveis:
search- Busca índice da memória com consultas full-text, filtra por tipo/data/projetotimeline- Obtém contexto cronológico ao redor de uma observação ou consulta específicaget_observations- Busca detalhes completos das observações pelos IDs (sempre em lote múltiplos)
Exemplo de Uso:
// Step 1: Search for index
search(query="authentication bug", type="bugfix", limit=10)
// Step 2: Review index, identify relevant IDs (e.g., #123, #456)
// Step 3: Fetch full details
get_observations(ids=[123, 456])
Veja Guia de Ferramentas de Busca para exemplos detalhados.
Recursos Beta
O Claude-Mem oferece um canal beta com recursos experimentais como o modo Endless Mode (arquitetura biomimética da memória para sessões estendidas). Alterne entre versões estáveis e beta na interface do web viewer em http://localhost:37777 → Configurações.
Veja a Documentação de Recursos Beta para detalhes sobre o modo Endless Mode e como testá-lo.
Requisitos do Sistema
- Node.js: 20.0.0 ou superior
- Claude Code: Última versão com suporte a plugins
- Bun: Runtime JavaScript e gerenciador de processos (instalado automaticamente se ausente)
- uv: Gerenciador de pacotes Python para busca vetorial (instalado automaticamente se ausente)
- SQLite 3: Para armazenamento persistente (incluso)
Notas sobre Configuração no Windows
Se você vir um erro como:
npm : The term 'npm' is not recognized as the name of a cmdlet
Certifique-se de que o Node.js e npm estão instalados e adicionados ao seu PATH. Baixe a versão mais recente do instalador do Node.js em https://nodejs.org e reinicie seu terminal após a instalação.
Configuração
As configurações são gerenciadas no ~/.claude-mem/settings.json (criado automaticamente com padrões na primeira execução). Configure o modelo de IA, porta do worker, diretório de dados, nível de log e configurações de injeção de contexto.
Veja o Guia de Configuração para todas as configurações disponíveis e exemplos.
Configuração de Modo & Idioma
O Claude-Mem suporta múltiplos modos de fluxo de trabalho e idiomas via a configuração CLAUDE_MEM_MODE.
Esta opção controla tanto:
- O comportamento do fluxo de trabalho (ex: code, chill, investigation)
- O idioma usado nas observações geradas
Como Configurar
Edite seu arquivo de configurações em ~/.claude-mem/settings.json:
{
"CLAUDE_MEM_MODE": "code--zh"
}
Os modos são definidos em plugin/modes/. Para ver todos os modos disponíveis localmente:
ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/
Modos Disponíveis
| Modo | Descrição |
|---|---|
code | Modo padrão em inglês |
code--zh | Modo chinês simplificado |
code--ja | Modo japonês |
Modos específicos de idioma seguem o padrão code--[lang], onde [lang] é o código do idioma ISO 639-1 (ex: zh para chinês, ja para japonês, es para espanhol).
Nota:
code--zh(Chinês Simplificado) já está incluído — não requer instalação adicional ou atualização de plugin.
Após Alterar o Modo
Reinicie o Claude Code para aplicar a nova configuração do modo.
Desenvolvimento
Veja o Guia de Desenvolvimento para instruções de build, testes e fluxo de contribuição.
Solução de Problemas
Se estiver enfrentando problemas, descreva-os ao Claude e a habilidade troubleshoot diagnosticará automaticamente e fornecerá correções.
Veja o Guia de Solução de Problemas para problemas comuns e soluções.
Relatórios de Bugs
Crie relatórios abrangentes de bugs com o gerador automatizado:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
Contribuindo
Contribuições são bem-vindas! Por favor:
- Faça um fork do repositório
- Crie uma branch para a feature
- Faça suas alterações com testes
- Atualize a documentação
- Envie um Pull Request
Veja Guia de Desenvolvimento para o fluxo de contribuição.
Licença
O Claude-Mem é licenciado sob a Apache License 2.0.
Escolhemos Apache-2.0 porque uma memória agencial durável deve ser fácil de incorporar em ferramentas de desenvolvedor, agentes locais, servidores MCP, sistemas empresariais, pilhas robóticas e harnesses de produção para agentes.
Veja o arquivo LICENSE para detalhes completos. Veja docs/license.md e docs/ip-boundary.md para escopo de licenciamento e a fronteira open/comercial.
Nota sobre Ragtime: O diretório ragtime/ é licenciado sob a Apache License 2.0. Veja ragtime/LICENSE para detalhes.
Suporte
- Documentação: docs/
- Issues: GitHub Issues
- Repositório: github.com/thedotmack/claude-mem
- Conta Oficial X: @Claude_Memory
- Discord Oficial: Junte-se ao Discord
- Autor: Alex Newman (@thedotmack)
Desenvolvido com Claude Agent SDK | Funciona com Claude Code | Feito em TypeScript
E o que é CMEM?
CMEM é um token criado por uma terceira parte, mas oficialmente abraçado pelo criador do Claude-Mem (Alex Newman, @thedotmack). O token atua como catalisador da comunidade para crescimento e veículo para levar o CMEM aos desenvolvedores e profissionais de conhecimento que mais precisam dele.
BASE CA Oficial: 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3