14 KiB
🌐 Esta é uma tradução automatizada. Correções da comunidade são bem-vindas!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
Sistema de compressão de memória persistente construído para Claude Code.
Início Rápido • Como Funciona • Ferramentas de Busca • Documentação • Configuração • Solução de Problemas • Licença
Claude-Mem preserva o contexto perfeitamente entre sessões, capturando automaticamente observações de uso de ferramentas, gerando resumos semânticos e disponibilizando-os para sessões futuras. Isso permite que Claude mantenha a continuidade do conhecimento sobre projetos mesmo após o término ou reconexão de sessões.
Início Rápido
Inicie uma nova sessão do Claude Code no terminal e digite os seguintes comandos:
> /plugin marketplace add thedotmack/claude-mem
> /plugin install claude-mem
Reinicie o Claude Code. O contexto de sessões anteriores aparecerá automaticamente em novas sessões.
Principais Recursos:
- 🧠 Memória Persistente - O contexto sobrevive entre sessões
- 📊 Divulgação Progressiva - Recuperação de memória em camadas com visibilidade de custo de tokens
- 🔍 Busca Baseada em Skill - Consulte seu histórico de projeto com a skill mem-search
- 🖥️ Interface Web de Visualização - Fluxo de memória em tempo real em http://localhost:37777
- 💻 Skill para Claude Desktop - Busque memória em conversas do Claude Desktop
- 🔒 Controle de Privacidade - Use tags
<private>para excluir conteúdo sensível do armazenamento - ⚙️ Configuração de Contexto - Controle refinado sobre qual contexto é injetado
- 🤖 Operação Automática - Nenhuma intervenção manual necessária
- 🔗 Citações - Referencie observações passadas com IDs (acesse via http://localhost:37777/api/observation/{id} ou visualize todas no visualizador web em http://localhost:37777)
- 🧪 Canal Beta - Experimente recursos experimentais como o Endless Mode através da troca de versões
Documentação
📚 Ver Documentação Completa - Navegar no site oficial
Começando
- Guia de Instalação - Início rápido e instalação avançada
- Guia de Uso - Como Claude-Mem funciona automaticamente
- Ferramentas de Busca - Consulte seu histórico de projeto com linguagem natural
- Recursos Beta - Experimente recursos experimentais como o Endless Mode
Melhores Práticas
- Engenharia de Contexto - Princípios de otimização de contexto para agentes de IA
- Divulgação Progressiva - Filosofia por trás da estratégia de preparação de contexto do Claude-Mem
Arquitetura
- Visão Geral - Componentes do sistema e fluxo de dados
- Evolução da Arquitetura - A jornada da v3 à v5
- Arquitetura de Hooks - Como Claude-Mem usa hooks de ciclo de vida
- Referência de Hooks - 7 scripts de hook explicados
- Serviço Worker - API HTTP e gerenciamento do Bun
- Banco de Dados - Schema SQLite e busca FTS5
- Arquitetura de Busca - Busca híbrida com banco de dados vetorial Chroma
Configuração e Desenvolvimento
- Configuração - Variáveis de ambiente e configurações
- Desenvolvimento - Build, testes e contribuição
- Solução de Problemas - Problemas comuns e soluções
Como Funciona
Componentes Principais:
- 5 Hooks de 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 de ciclo de vida)
- Serviço Worker - API HTTP na porta 37777 com interface de visualização web e 10 endpoints de busca, gerenciado pelo Bun
- Banco de Dados SQLite - Armazena sessões, observações, resumos
- Skill mem-search - Consultas em linguagem natural com divulgação progressiva
- Banco de Dados Vetorial Chroma - Busca híbrida semântica + palavra-chave para recuperação inteligente de contexto
Veja Visão Geral da Arquitetura para detalhes.
Skill mem-search
Claude-Mem fornece busca inteligente através da skill mem-search que se auto-invoca quando você pergunta sobre trabalhos anteriores:
Como Funciona:
- Apenas pergunte naturalmente: "O que fizemos na última sessão?" ou "Já corrigimos esse bug antes?"
- Claude invoca automaticamente a skill mem-search para encontrar contexto relevante
Operações de Busca Disponíveis:
- Search Observations - Busca de texto completo em observações
- Search Sessions - Busca de texto completo em resumos de sessão
- Search Prompts - Busca em solicitações brutas do usuário
- By Concept - Encontre por tags de conceito (discovery, problem-solution, pattern, etc.)
- By File - Encontre observações que referenciam arquivos específicos
- By Type - Encontre por tipo (decision, bugfix, feature, refactor, discovery, change)
- Recent Context - Obtenha contexto de sessão recente para um projeto
- Timeline - Obtenha linha do tempo unificada de contexto em torno de um ponto específico no tempo
- Timeline by Query - Busque observações e obtenha contexto de linha do tempo em torno da melhor correspondência
- API Help - Obtenha documentação da API de busca
Exemplos de Consultas em Linguagem Natural:
"Quais bugs corrigimos na última sessão?"
"Como implementamos a autenticação?"
"Quais mudanças foram feitas em worker-service.ts?"
"Mostre-me trabalhos recentes neste projeto"
"O que estava acontecendo quando adicionamos a interface de visualização?"
Veja Guia de Ferramentas de Busca para exemplos detalhados.
Recursos Beta
Claude-Mem oferece um canal beta com recursos experimentais como Endless Mode (arquitetura de memória biomimética para sessões estendidas). Alterne entre versões estável e beta pela interface de visualização web em http://localhost:37777 → Settings.
Veja Documentação de Recursos Beta para detalhes sobre o Endless Mode e como experimentá-lo.
Requisitos do Sistema
- Node.js: 18.0.0 ou superior
- Claude Code: Versão mais recente 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 (incluído)
Configuração
As configurações são gerenciadas em ~/.claude-mem/settings.json (criado automaticamente com valores padrão na primeira execução). Configure 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.
Desenvolvimento
Veja o Guia de Desenvolvimento para instruções de build, testes e fluxo de contribuição.
Solução de Problemas
Se você estiver enfrentando problemas, descreva o problema para Claude e a skill troubleshoot diagnosticará automaticamente e fornecerá correções.
Veja o Guia de Solução de Problemas para problemas comuns e soluções.
Relatos de Bug
Crie relatos de bug abrangentes 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 de 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
Este projeto está licenciado sob a GNU Affero General Public License v3.0 (AGPL-3.0).
Copyright (C) 2025 Alex Newman (@thedotmack). Todos os direitos reservados.
Veja o arquivo LICENSE para detalhes completos.
O Que Isso Significa:
- Você pode usar, modificar e distribuir este software livremente
- Se você modificar e implantar em um servidor de rede, você deve disponibilizar seu código-fonte
- Trabalhos derivados também devem ser licenciados sob AGPL-3.0
- NÃO HÁ GARANTIA para este software
Nota sobre Ragtime: O diretório ragtime/ é licenciado separadamente sob a PolyForm Noncommercial License 1.0.0. Veja ragtime/LICENSE para detalhes.
Suporte
- Documentação: docs/
- Issues: GitHub Issues
- Repositório: github.com/thedotmack/claude-mem
- Autor: Alex Newman (@thedotmack)
Construído com Claude Agent SDK | Desenvolvido por Claude Code | Feito com TypeScript