zikra

Zikra est un serveur de mémoire persistante natif MCP, conçu pour être utilisé avec Claude Code et d’autres agents d’IA de codage. Le README le présente comme une couche de mémoire partagée et gouvernée pour les équipes qui exécutent plusieurs agents, personnes et projets. Le serveur peut être exécuté localement, se lie par défaut à localhost:8000 et utilise l’authentification par jeton Bearer. Il peut être ajouté à Claude Code en tant que serveur MCP via une URL et un en-tête d’autorisation, et le projet fournit un installateur interactif ainsi qu’un script de mise à jour. Les principales capacités décrites incluent la prise en charge de plusieurs agents (Claude Code, Gemini CLI, Codex ou tout agent capable de POST), l’accès basé sur les rôles avec les rôles propriétaire, administrateur, développeur et spectateur, et des espaces de noms de projet isolés afin qu’une équipe puisse maintenir des pools de mémoire séparés par projet. La mémoire est structurée plutôt que du texte brut : l’ensemble de commandes couvre l’enregistrement des mémoires et des invites, la journalisation des exécutions et des erreurs, l’enregistrement et la liste des exigences, la promotion des types d’exigences et la récupération des éléments par titre ou ID. La recherche est décrite comme hybride sémantique plus mots-clés lorsque les embeddings sont activés ; sans OPENAI_API_KEY, le README indique qu’elle se rabat sur la recherche par mots-clés uniquement. Le classement prend en compte l’âge, la fréquence d’accès et le score de confiance. Le stockage peut utiliser SQLite pour les configurations locales ou à utilisateur unique, ou PostgreSQL pour les déploiements d’équipe. Le backend PostgreSQL est configuré via les variables d’environnement DB_BACKEND et DB_*, avec une option d’installation supplémentaire pour postgres. La description du dépôt mentionne également pgvector et n8n comme faisant partie de la pile, et l’endpoint de commande webhook documenté est /webhook/zikra. Les embeddings peuvent utiliser OpenAI ou un endpoint compatible via OPENAI_API_BASE. Les options de configuration incluent le jeton, les paramètres de la base de données, l’adresse de liaison, le port, le projet par défaut, le modèle d’embedding, les jours de décroissance et le poids de fréquence. Pour Claude Code, les invites de configuration installent les hooks Stop et PreCompact ainsi qu’une barre de statut, permettant la journalisation automatique des sessions. Une invite d’hygiène intégrée est décrite pour la décroissance de la confiance, la détection des orphelins et le nettoyage des éléments obsolètes. Le projet est sous licence MIT.