Memento v1.0: Memória Persistente Local para Agentes de IA de Codificação

O que o Memento v1.0 faz

O Memento v1.0 fornece uma camada de memória persistente local-first para agentes de IA de programação. Tudo roda na sua máquina — embeddings, armazenamento e busca — sem requisitos de nuvem ou chaves de API necessárias após a configuração.

Detalhes técnicos principais

Embeddings: Usa all-MiniLM-L6-v2 via @xenova/transformers (384 dimensões) rodando totalmente offline. Embeddings opcionais em nuvem via variáveis de ambiente para OpenAI (text-embedding-3-small) ou Gemini (embedding-001).

Armazenamento: JSON local + índice HNSW por padrão. Suporte opcional para ChromaDB ou Neo4j.

Busca: Índice HNSW para busca aproximada do vizinho mais próximo (<50ms em 2000+ memórias). Implementação completa BM25 com k1=1.2, b=0.75 para busca por palavras-chave. Modo híbrido combinando 70% similaridade de cosseno + 30% BM25.

Deduplicação: SHA-256 + limite de 0.92 de similaridade de cosseno.

Recursos de resiliência: Circuit breaker, write-ahead log, cache LRU.

Gerenciamento de memória: Decaimento exponencial de 347 dias em pontuações de importância.

Configuração e uso

Instale com: npx memento-memory setup

Ferramenta de migração: memory_migrate re-embeds todo o seu armazenamento ao trocar de provedores de embedding — sem perda de dados.

Suporte a IDEs e ferramentas

Compatibilidade multi-IDE: Claude Code, Cursor, Windsurf, OpenCode — todos compartilham o mesmo armazenamento local.

17 ferramentas MCP através de salvar/recuperar/buscar/exportar/importar/ingest/compact/graph/ciclo de vida de sessão.

Privacidade e licenciamento

Zero telemetria — suas decisões arquiteturais e padrões de código nunca saem da sua máquina. Funciona sem internet após a configuração. Licenciado AGPL-3.0 e auto-hospedável em um comando.