convez.ai
SkillAutomaçãoIntermediário
thedotmack

Claude-Mem

thedotmack/claude-mem

Memória persistente comprimida para agentes IA entre sessões

Ver no GitHub
ExcelentePluginScore · de 0 a 100

Sistema 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-mem

1 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

Estrelas
118 mil
Forks
10 mil
Acompanhando
363
Saúde
71%
Último commit
há 1 dia
Versão
v16.0.0
Issues abertas
91
Contribuidores
121

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-mem instala apenas a SDK/biblioteca — ele não registra os hooks do plugin nem configura o serviço de worker. Sempre instale via npx claude-mem install ou os comandos /plugin acima.

🦞 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

Melhores Práticas

Arquitetura

Configuração e Desenvolvimento


Como Funciona

Componentes Principais:

  1. 5 Hooks do Ciclo de Vida - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (6 scripts de hook)
  2. Instalação Inteligente - Verificador de dependências em cache (script pré-hook, não um hook do ciclo de vida)
  3. Serviço Worker - API HTTP na porta 37777 com interface web viewer e 10 endpoints de busca, gerenciado pelo Bun
  4. Banco de Dados SQLite - Armazena sessões, observações e resumos
  5. Habilidade mem-search - Consultas em linguagem natural com revelação progressiva
  6. 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:

  1. search - Obtém índice compacto com IDs (~50-100 tokens/result)
  2. timeline - Obtém contexto cronológico ao redor dos resultados interessantes
  3. get_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 search para obter um índice de resultados
  • Use timeline para ver o que estava acontecendo ao redor de observações específicas
  • Use get_observations para buscar detalhes completos dos IDs relevantes
  • ~10x economia de tokens filtrando antes de buscar os detalhes

Ferramentas MCP Disponíveis:

  1. search - Busca índice da memória com consultas full-text, filtra por tipo/data/projeto
  2. timeline - Obtém contexto cronológico ao redor de uma observação ou consulta específica
  3. get_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

ModoDescrição
codeModo padrão em inglês
code--zhModo chinês simplificado
code--jaModo 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:

  1. Faça um fork do repositório
  2. Crie uma branch para a feature
  3. Faça suas alterações com testes
  4. Atualize a documentação
  5. 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


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

Ver o original no GitHub

Bom para

Relacionados