hippo-memory

Hippo é uma camada de memória para agentes de codificação de IA, distribuída como o pacote npm `hippo-memory`. Sua premissa declarada é que boa memória significa saber o que esquecer: memórias que se revelaram erradas, foram substituídas ou nunca foram usadas devem cair no ranking ou sair completamente da recuperação. É licenciado sob MIT e requer Node.js 22.16+. Armazenamento e recuperação As memórias ficam em um banco de dados SQLite local em `.hippo/hippo.db`, com espelhos markdown gravados após cada alteração para que o armazenamento seja legível por humanos e rastreável por git. A busca é BM25 por padrão, sem modelo e sem chamada de rede; embeddings são uma instalação opcional (Transformers.js local, ou embedders de API opt-in da OpenAI, Voyage ou Cohere). O projeto relata zero dependências em tempo de execução. Um servidor MCP e uma API HTTP expõem o armazenamento a qualquer cliente compatível. Aprendendo com resultados Dois mecanismos são descritos como medidos: marcar uma memória recuperada como errada reduz seu ranking, e o uso repetido fortalece uma memória. `hippo supersede` remove um fato substituído da recuperação. Memórias marcadas com erro recebem o dobro da meia-vida das comuns. A meia-vida padrão é de 365 dias; o README observa uma avaliação pré-registrada em que 7 dias perderam a versão atual de um fato com muito mais frequência, enquanto 730 dias e decaimento desativado empataram com 365. Decaimento, armazenamento em três camadas e consolidação durante o sono são descritos como inspirados no hipocampo, e o README afirma que em seus testes o decaimento empatou com o decaimento desativado e o sono reduziu a recuperação. Configuração e integrações `hippo init` executado dentro de um projeto cria o armazenamento `.hippo/`, adiciona um bloco marcado a um `CLAUDE.md` ou `AGENTS.md` existente, instala hooks para agentes detectados (configurações do Claude Code, um plugin OpenCode, entradas `hooks.json` do Codex que exigem confiança única) e agenda uma execução diária às 6h15. `hippo init --scan <pasta>` encontra repositórios git até três níveis de profundidade e semeia cada um a partir dos últimos 365 dias de commits. As flags `--no-hooks`, `--no-schedule` e `--no-learn` pulam partes individuais. `hippo doctor` verifica a configuração. Recursos Importadores cobrem exportações do ChatGPT, CLAUDE.md, regras do Cursor, markdown e texto simples, com dry-run e detecção de duplicatas. A captura de conversas extrai decisões, regras, erros e preferências com heurísticas de padrões em vez de um LLM. Conectores de webhook do Slack e GitHub ingerem eventos como memórias brutas com proveniência e tratamento de exclusão. Comandos adicionais cobrem snapshots de tarefas ativas, trilhas de eventos de sessão, handoffs, um scratchpad de memória de trabalho limitado, níveis de confiança (verificado, observado, inferido, obsoleto), rastreamento de conflitos, invalidação em commits de migração e recuperação explicável via `hippo recall --why`. Notas de privacidade A recuperação não faz chamada de rede por padrão. O README divulga que `hippo sleep` envia texto de memória para a Anthropic para extração de fatos quando `ANTHROPIC_API_KEY` está definida, e que isso pode ser desativado em `.hippo/config.json`. O reranker hospedado TypeSafe Jev é opt-in e desativado por padrão. Evidências e ressalvas O README vincula cada afirmação a um benchmark ou teste, incluindo um benchmark de aprendizado sequencial, um resultado de divisão oracle do LongMemEval (R@5 = 74,0% apenas com BM25), uma avaliação privada de reranker com 300 consultas e um corpus Slack em etapas. Também afirma que uma alegação anterior de magnitude foi retratada e que o mecanismo de supersede não foi medido. O projeto relata mais de 3.500 testes contra um banco de dados real, sem mocks de módulos.