open-zk-kb

Abres una nueva sesión y tu agente no tiene idea de quién eres. Otra vez. Vuelves a explicar tu stack, tus convenciones, ese caso límite que has corregido cinco veces.

open-zk-kb le da a tu agente una memoria — para que las correcciones se mantengan, el contexto se acumule y cada sesión comience más inteligente que la anterior.

Inicio rápido

Requiere Bun — instala con curl -fsSL https://bun.sh/install | bash

bunx open-zk-kb@latest

El instalador configura tus clientes seleccionados, instala las instrucciones del agente y crea un vault local. Clientes compatibles: OpenCode, Claude Code, Cursor, Windsurf, Zed, Pi y OMP.

Consulta la Guía de configuración para la instalación manual y la resolución de problemas.

Related MCP server: Memento

¿Por qué open-zk-kb?

Tu agente empieza desde cero en cada sesión. Sin memoria, sin curva de aprendizaje. Corriges los mismos errores, vuelves a explicar las mismas convenciones, vuelves a enseñar el mismo contexto. Cambia de herramientas y es aún peor: tu agente de Cursor no sabe lo que aprendió tu agente de Claude.

open-zk-kb lo soluciona.

• Corrígelo una vez, se mantiene — tu agente guarda correcciones, preferencias y decisiones. En la próxima sesión, ya lo sabe.

• Funciona en todas las herramientas — una base de conocimiento compartida por Claude Code, Cursor, Windsurf, OpenCode, Zed, Pi y OMP

• Encuentra lo relevante — la búsqueda híbrida coincide con el significado, no solo con palabras clave, para que solo aparezca el contexto útil

• Se ejecuta localmente — sin claves de API, sin nube, funciona sin conexión. Tus datos permanecen en tu máquina.

• Legible para humanos — archivos Markdown simples que puedes explorar, editar y controlar versiones

• Código abierto — con licencia MIT

Pi: herramientas de conocimiento nativas

Instala el paquete de Pi y luego reinicia Pi:

pi install npm:open-zk-kb

La extensión expone las diez herramientas knowledge-* directamente en Pi. Los resultados usan la representación compacta nativa de Pi: búsqueda, almacenamiento, contexto y salud tienen resúmenes enfocados y detalles expandibles, mientras que las otras herramientas muestran una salida de estado concisa. El servidor MCP y el trabajo local de SQLite/embeddings siguen ejecutándose con Bun >= 1.0; Pi mismo se ejecuta bajo su runtime de Node.js compatible. Por lo tanto, instalar Bun es necesario incluso al usar el paquete de Pi.

Pi también carga las preferencias activas del proyecto automáticamente cuando comienza una sesión y las inyecta en el contexto del modelo sin requerir una búsqueda iniciada por el modelo. La entrada visible knowledge-context informa lo que sucedió sin inventar una llamada a herramienta.

Consulta la guía de experiencia de Pi para el flujo de trabajo completo de preferencias y ejemplos de renderizado. Para instrucciones gestionadas por el instalador, verificación y resolución de problemas, consulta Instalación de Pi.

Configuración

No se requiere configuración. Los embeddings locales funcionan de inmediato sin clave de API.

Consulta la Guía de configuración para embeddings, ruta del vault, ajustes del ciclo de vida y configuración del servidor.

Bajo el capó

Construido sobre el método Zettelkasten: notas atómicas y enlazadas con tipos estructurados. Cada nota captura un concepto (una decisión, una preferencia, un detalle) y se enlaza con notas relacionadas, construyendo un grafo de conocimiento interconectado.

La búsqueda combina la indexación de texto completo SQLite FTS5 con embeddings vectoriales locales (MiniLM-L6-v2) para la coincidencia semántica. Los archivos Markdown son la fuente de verdad; la base de datos es un índice reconstruible.

Telemetría

Cuando está habilitado (telemetry.enabled: true y telemetry.share: true), open-zk-kb envía un evento anónimo por cada sesión completada a PostHog (EU Cloud) en un inicio posterior. Incluye un cliente canónico, IDs de modelo limitados, tamaño del vault y recuentos de las diez herramientas, no el contenido de las notas, consultas, rutas, nombres o direcciones de correo electrónico. Los valores predeterminados en tiempo de ejecución están deshabilitados; el instalador interactivo habilita el intercambio solo después de un consentimiento afirmativo, mientras que las instalaciones desatendidas y directas del paquete permanecen deshabilitadas a menos que se configuren por separado. Establece DO_NOT_TRACK=1 para bloquear incondicionalmente el intercambio (los contadores locales de SQLite no se ven afectados), o mantén ambas banderas en false. Consulta Telemetría para el esquema completo del evento y los detalles.

Documentación

• Guía de configuración — instalación, configuración específica del cliente, resolución de problemas

• Experiencia de Pi — herramientas nativas, preferencias automáticas y galería de renderizado

• Referencia de herramientas — las 10 herramientas MCP con parámetros y ejemplos

• Ciclo de vida de notas — tipos de notas, estados, sistema de revisión

• Configuración — embeddings, vault, ciclo de vida y configuración del servidor

• Arquitectura — almacenamiento dual, modelo de propiedad, decisiones de diseño

• Desarrollo — desarrollo local, pruebas, depuración

• Contribuir — pautas para contribuyentes

Licencia

MIT License