CogniLayer: Um Servidor MCP para Memória Persistente no Claude Code

CogniLayer é um servidor MCP construído especificamente para o Claude Code que fornece memória persistente entre sessões. A ferramenta aborda o problema em que o Claude Code esquece tudo ao iniciar uma nova sessão—incluindo arquitetura do projeto, decisões anteriores e insights de depuração—forçando os usuários a reexplicar o contexto repetidamente.

Implementação Técnica

O sistema utiliza um banco de dados SQLite com busca de texto completo FTS5 e incorporações vetoriais (fastembed + sqlite-vec) para armazenar conhecimento localmente. Ele implementa busca híbrida que combina correspondência de palavras-chave com similaridade vetorial semântica.

Principais Recursos

• Armazena 14 tipos de fatos: decisões, padrões, pegadinhas, correções de erros, contratos de API e mais
• Detecção de desatualização: alerta quando fatos lembrados fazem referência a arquivos alterados
• Pontes de sessão: passa automaticamente o contexto entre sessões
• Sistema de decaimento de calor: fatos envelhecem com o tempo (quente/morno/frio) com informações frequentemente acessadas permanecendo relevantes
• Sistema de Cartão de Identidade: evita implantação no servidor errado
• 3 ganchos: SessionStart, SessionEnd, PostToolUse
• 10 ferramentas MCP e 7 comandos de barra

Configuração e Uso

Para instalar e usar o CogniLayer:

git clone https://github.com/LakyFx/CogniLayer.git
python install.py

Após iniciar o Claude Code em qualquer projeto, execute o comando /onboard. A ferramenta funciona inteiramente localmente com SQLite e funciona no Windows, macOS e Linux.

O projeto foi construído usando sessões do Claude Code, com o Claude ajudando a projetar o esquema do banco de dados, escrever o servidor MCP, construir o sistema de ganchos, implementar o classificador de busca híbrida e iterar no pipeline de incorporação. A ferramenta é 100% gratuita, de código aberto sob GPL v3, com strings de UI atualmente em tcheco, mas funcional com qualquer idioma.