ramakay/claude-self-reflect

O que é?

Recursos principais

• 01Busca semântica em conversas anteriores do Claude Code usando embeddings locais
• 02Binário Rust único com armazenamento no SQLite e índice vetorial HNSW, sem serviços externos
• 03Seis hooks de ciclo de vida que inserem automaticamente contexto relevante de conversas anteriores
• 0415 ferramentas MCP para consultas por arquivo, conceito, linha do tempo e conversa
• 05Grafo de código que relaciona funções e arquivos às conversas que os moldaram
• 06Configuração baseada em consentimento, que instala o registro MCP e os hooks somente quando ativada

Casos de uso

• Relembrar como um bug foi corrigido ou como um componente foi projetado em uma sessão anterior do Claude Code
• Encontrar as conversas que levaram ao código atual de determinado arquivo ou função
• Manter decisões de projetos de longa duração disponíveis ao longo de várias sessões

Início rápido

1. 1

   Execute o script oficial de instalação do README (baixa o binário e pede confirmação antes de ativá-lo).

2. 2

   Instale via npm (baixa apenas o binário, sem ativação).

   npm install -g claude-self-reflect
3. 3

   Ative a configuração (registra o servidor MCP, instala os hooks e importa as conversas).

   csr-engine setup
4. 4

   Reinicie o Claude Code.

Antes de usar

• !Os binários pré-compilados são compatíveis com macOS Apple Silicon, Linux x86_64/WSL e Linux ARM64; no Mac Intel, é necessário compilar a partir do código-fonte.
• !As narrativas de IA são opcionais, mas usam sua assinatura do Claude via claude -p e consomem tokens.

Em coleções

Tópicos

Perguntas frequentes

O que é claude-self-reflect?

Ferramenta local em Rust que dá ao Claude Code memória persistente de conversas anteriores por meio de busca semântica, disponibilizada como servidor MCP. Claude Self-Reflect é uma camada de memória para o Claude Code. Ela indexa transcrições de conversas anteriores em ~/.claude/projects e permite pesquisá-las, para que soluções, decisões de design e histórico de depuração de sessões anteriores possam ser recuperados quando forem relevantes. É distribuída como um único binário Rust que armazena trechos, embeddings e o estado de enriquecimento no SQLite, e usa um índice HNSW para busca vetorial, com embeddings locais do FastEmbed. A busca principal não exige servidor de banco de dados, container nem chave de API.

claude-self-reflect é gratuito? Qual é a licença?

claude-self-reflect é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

claude-self-reflect ainda é mantido?

Manutenção ativa. O último commit de claude-self-reflect foi em 2 de nov. de 2026.

Para que posso usar claude-self-reflect?

Relembrar como um bug foi corrigido ou como um componente foi projetado em uma sessão anterior do Claude Code Encontrar as conversas que levaram ao código atual de determinado arquivo ou função Manter decisões de projetos de longa duração disponíveis ao longo de várias sessões

Como instalar claude-self-reflect?

Execute o script oficial de instalação do README (baixa o binário e pede confirmação antes de ativá-lo). Instale via npm (baixa apenas o binário, sem ativação).: npm install -g claude-self-reflect Ative a configuração (registra o servidor MCP, instala os hooks e importa as conversas).: csr-engine setup Reinicie o Claude Code.

Onde consigo claude-self-reflect?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ramakay/claude-self-reflect