zikra

Zikra es un servidor de memoria persistente nativo de MCP destinado a ser utilizado con Claude Code y otros agentes de codificación de IA. El README lo presenta como una capa de memoria compartida y gobernada para equipos que ejecutan múltiples agentes, personas y proyectos. El servidor puede ejecutarse localmente, se vincula de forma predeterminada a localhost:8000 y utiliza autenticación por token Bearer. Se puede agregar a Claude Code como un servidor MCP a través de una URL y un encabezado de autorización, y el proyecto proporciona un instalador interactivo más un script de actualización. Las capacidades clave descritas incluyen soporte para múltiples agentes (Claude Code, Gemini CLI, Codex o cualquier agente que pueda hacer POST), acceso basado en roles con roles de propietario, administrador, desarrollador y visor, y espacios de nombres de proyectos aislados para que un equipo pueda mantener grupos de memoria separados por proyecto. La memoria está estructurada en lugar de ser texto plano: el conjunto de comandos cubre el guardado de memorias y prompts, el registro de ejecuciones y errores, el guardado y listado de requisitos, la promoción de tipos de requisitos y la recuperación de elementos por título o ID. La búsqueda se describe como híbrida semántica más por palabras clave cuando las embeddings están habilitadas; sin OPENAI_API_KEY, el README dice que se recurre solo a la búsqueda por palabras clave. La clasificación considera la antigüedad, la frecuencia de acceso y la puntuación de confianza. El almacenamiento puede utilizar SQLite para configuraciones locales o de un solo usuario, o PostgreSQL para despliegues de equipos. El backend de PostgreSQL se configura a través de las variables de entorno DB_BACKEND y DB_*, con una opción de instalación de postgres adicional. La descripción del repositorio también menciona pgvector y n8n como parte de la pila, y el endpoint de comando de webhook documentado es /webhook/zikra. Las embeddings pueden usar OpenAI o un endpoint compatible a través de OPENAI_API_BASE. Las opciones de configuración incluyen token, configuración de la base de datos, dirección de vinculación, puerto, proyecto predeterminado, modelo de embedding, días de decaimiento y peso de frecuencia. Para Claude Code, los prompts de configuración instalan los hooks Stop y PreCompact más una barra de estado, lo que permite el registro automático de sesiones. Se describe un prompt de higiene incorporado para el decaimiento de la confianza, la detección de huérfanos y la limpieza de elementos obsoletos. El proyecto tiene licencia MIT.