zikra

Zikra é um servidor de memória persistente nativo de MCP, destinado ao uso com Claude Code e outros agentes de codificação de IA. O README o enquadra como uma camada de memória compartilhada e governada para equipes que executam vários agentes, pessoas e projetos. O servidor pode ser executado localmente, se vincula a localhost:8000 por padrão e usa autenticação por token Bearer. Ele pode ser adicionado ao Claude Code como um servidor MCP por meio de uma URL e um cabeçalho de autorização, e o projeto fornece um instalador interativo, além de um script de atualização. As principais capacidades descritas incluem suporte a vários agentes (Claude Code, Gemini CLI, Codex ou qualquer agente que possa POST), acesso baseado em função com funções de proprietário, administrador, desenvolvedor e visualizador, e namespaces de projeto isolados para que uma equipe possa manter pools de memória separados por projeto. A memória é estruturada em vez de texto simples: o conjunto de comandos cobre o salvamento de memórias e prompts, o registro de execuções e erros, o salvamento e a listagem de requisitos, a promoção de tipos de requisitos e a recuperação de itens por título ou ID. A pesquisa é descrita como híbrida semântica mais por palavra-chave quando os embeddings estão habilitados; sem OPENAI_API_KEY, o README diz que ela cai para apenas por palavra-chave. A classificação considera idade, frequência de acesso e pontuação de confiança. O armazenamento pode usar SQLite para configurações locais ou de usuário único, ou PostgreSQL para implantações de equipe. O backend do PostgreSQL é configurado por meio das variáveis de ambiente DB_BACKEND e DB_*, com uma opção extra de instalação do postgres. A descrição do repositório também menciona pgvector e n8n como parte da pilha, e o endpoint de comando de webhook documentado é /webhook/zikra. Os embeddings podem usar OpenAI ou um endpoint compatível por meio de OPENAI_API_BASE. As opções de configuração incluem token, configurações de banco de dados, endereço de vinculação, porta, projeto padrão, modelo de embedding, dias de decaimento e peso de frequência. Para o Claude Code, os prompts de configuração instalam os hooks Stop e PreCompact, além de uma barra de statusline, permitindo o registro automático de sessões. Um prompt de higiene integrado é descrito para o decaimento de confiança, a detecção de órfãos e a limpeza de itens obsoletos. O projeto é licenciado sob a MIT.