Tu agente olvida todo al cerrar el chat. Este kit le da una memoria que sobrevive entre
sesiones: una carpeta de notas Markdown en tu propio repo git que el modelo lee y escribe por
MCP. Sin nube, sin cuenta, sin lock-in — si mañana borras el kit, tus notas siguen ahí y las
abre cualquier editor de texto.
1. Un comando conecta tu editor a un vault (lo crea si no existe, fusiona tu mcp.json sin
romper otras entradas, hace backup):
npx @vkmikc/create-vkm-kit -y
2.Reinicia tu editor. Los servidores MCP cargan al arrancar; ningún agente puede
cargarlos en caliente, ni el que acabó de instalarlos.
3. En un chat nuevo, pídele esto:
«Lee START_HERE.md de mi vault y dime qué contiene.»
Si te responde con el contenido, ya tienes memoria persistente. Eso es todo lo que necesitas
para empezar — de aquí para abajo es opcional.
Enfocado primero en Codex, Claude Code y Kimi Code (también cablea Cursor), con todas las
funciones activas por defecto: registra el MCP en los cuatro, activa la búsqueda híbrida (BM25, semántica y grafo), el grafo de
conocimiento (relaciones tipadas y observaciones), los memory reports, la aceleración
sqlite-vec, la seguridad multi-escritor (etag, ifMatch y lock de escritura, ADR-0037) y el
bucle de memoria evolutiva (recall de fallos, boost por uso, propuestas de memory-reflect,
ADR-0038), instala el backend Python, construye el índice e instala las reglas — sin preguntas.
Córrelo desde un clon del kit (o pásale --repo-root <clon>):
Si no hay clon a mano, --fullno aborta: cae a basic-memory (sin híbrido) y avisa.
Dile «linkea el repo e instálalo con todas sus herramientas y capacidades»: clona y ejecuta
npm install + npm run setup — preflight de dependencias → instalación --full (memoria
híbrida + token-saver + vkm-doctor + vkm-spec + skills) → verificación → aviso de reinicio.
Paso a paso: 🇪🇸 instalar con agente ·
🇬🇧 install with an agent.
npx @vkmikc/create-vkm-kit # asistente interactivo (pre-marca Codex + Claude)
npx @vkmikc/create-vkm-kit "<RUTA>" -y # sin preguntas, en la ruta que elijas
Mantenerlo al día (ADR-0061).--check-update compara tu versión con la de npm y dice qué
plantillas de skills/subagentes cambiaron — no escribe nada y nunca falla (sin red imprime
"skipped" y sale 0). --update aplica ese plan: instala lo que falta o lo que cambió el kit, y
deja intacto cualquier archivo que hayas editado tú (lo lista por nombre; --force lo pisa y
descarta tus cambios, --dry-run previsualiza sin escribir).
Claude Code / Codex / Kimi Code en PC nuevo.--full ya registra el MCP vía claude mcp add /
codex mcp add (en Kimi Code lo fusiona directo en ~/.kimi-code/mcp.json — no existe
kimi mcp add) y construye el índice en el mismo comando. En Kimi Code además instala las reglas
en ~/.kimi-code/AGENTS.md, las skills, el agente vkm-implementer y dos hooks: el mapa del vault
en el primer prompt de cada sesión y un recordatorio de cierre una vez por sesión (ADR-0087; el
hook Stop no corre en modo kimi -p). Para Claude Code además deja el vault
como única memoria: apaga la auto-memoria nativa (autoMemoryEnabled:false), instala un hook
SessionStart del vault (ADR-0029), dos hooks de aplicación determinista — bloqueo de escritura a
la memoria nativa + recordatorio de cierre — para que funcione con cualquier modelo (ADR-0030), y
un "effort advisor" que calibra coste sin interrumpir jamás: persiste el nivel de esfuerzo que el
trabajo pide para la próxima sesión y te avisa una sola vez fuera del contexto del modelo (ADR-0081). ¿Solo lo básico? usa --ide codex,claude. Guía completa:
🇪🇸 instalar en PC nueva ·
🇬🇧 fresh-PC install.
El nombre npm antiguo (@vkmikc/create-obsidian-memory) está deprecado y congelado en el kit v3
(3.15.0): no reenvía al nuevo, así que si lo tienes fijado en un script, cámbialo a
@vkmikc/create-vkm-kit.
🧠 Deja de repetir contexto. Las decisiones, preferencias y lecciones de ayer siguen ahí hoy,
en cualquier chat y con cualquier modelo.
💸 Gasta menos tokens haciéndolo. El recall devuelve la sección que responde, no la nota
entera: −62 % de tokens medidos contra leer notas completas, con gate en CI que rompe el build
si regresa.
🔒 Es tuyo y es legible. Markdown plano en tu repo git. Ninguna nota sale de tu máquina, y el
día que dejes el kit te quedas con todas.
Lo único obligatorio es el servidor MCP. Todo lo demás abajo es opcional y casi todo se activa
cuando lo pides — la excepción es la proyección Postgres, que viene puesta y se quita con
--no-postgres. Por eso la instalación es un comando aunque la lista sea larga.
MCP de web sigilosa (opt-in --obscura; corre desde el clon): obscura_fetch + obscura_search (SearXNG → SERP multi-motor → fallback nativo) + obscura_research (crawl profundo y rankeo BM25 100% local, cero tokens extra — ADR-0054) + obscura_research_start (jobs de investigación en segundo plano, hasta 30 min — ADR-0060) vía el navegador headless obscura.
MCP de descargas guiadas (opt-in --downloads; adrede fuera de --full — escribe a disco; corre desde el clon): download_resolve (solo metadatos) → confirmar → descargar a ~/Downloads/vkm-kit/; jobs en segundo plano con resume, sets y mirror más rápido (ADR-0058/0059).
Proyección Postgres del índice (opt-out --no-postgres; PGlite embebido o tu propio servidor con --pg-dsn): grafo tipado multi-salto en una consulta, analíticas SQL de todo el vault, log temporal de actividad y eventos en vivo por SSE. Derivada y desechable — el vault sigue mandando (ADR-0084).
Consola del kit entero en tiempo real (opt-in --console): daemon, memoria, tokens, actividad Postgres y research, en 127.0.0.1:4930. Binario único, solo lectura, y no abre ninguna ventana salvo que pases --open (ADR-0085).
ℹ️ obscura es software de terceros bajo licencia Apache-2.0 (h4ckf0r0day/obscura). El kit lo descarga del release oficial y lo verifica por SHA-256 — no lo empaqueta ni redistribuye. Búsqueda estructurada vía SearXNG on-demand (se levanta solo al buscar, se apaga al terminar; monitor de escritorio opcional) — ADR-0052.
🧭 Skills que instala el kit (además de los paquetes): /vkm-discipline — disciplina de ejecución cross-dominio (infiere la intención real, entrega más que lo literal, con evidencia ejecutada) que sube el rendimiento de cualquier modelo, Haiku a Opus — /vkm-spec (idea → spec anclada al vault) — /vkm-design (diseño profesional anti-genérico para cualquier UI/medio: dirección antes de píxeles, checks computados, librerías reales verificadas online, loop visual) — /vkm-research (consolida un banco RESEARCH/<tema> en un summary.md con wikilinks y supersesión) — /vkm-verify (demuestra que un check verde realmente corrió, cubrió tu cambio y sabe fallar: control negativo con prove-it.mjs) — /vkm-intake (lee bien la tarea antes de ejecutar: objetivo/entregable/no-hacer en 3 líneas, una sola pregunta cerrada si hay ambigüedad, inventario de lo que muestran las imágenes, contexto mínimo) — /vkm-seo (SEO brutal y medible para webs: cobertura semántica de sinónimos/variantes/ubicaciones, técnica + schema + visibilidad en búsqueda con IA, con audit estático antes/después) — y /vkm-ui-judge (juicio visual medido de cualquier GUI: web con audit Playwright en 3 viewports × claro/oscuro y contraste WCAG computado; Flutter con los gates de accesibilidad de flutter_test; Qt/.NET/Python/Java con loop de screenshots reales — arregla con evidencia antes/después en vez de "pensar mirando"). Cuál usar en cada situación: guía de skills. Detalle: ADR-0049, ADR-0053 y ADR-0056.
Economía de tokens, medida y con candado en CI · Token economy, measured and CI-locked: recall
passage-first −62% vs leer notas enteras (coste real del wire, k=3), assemble_context−68% de tokens de wire (mediana) vs encadenar búsquedas (gate CI 0.60/0.90), token-saver
≥30% de compactación con cero pérdida de diagnóstico (gate CI) y ≈ −1.300 tokens/sesión
de renta fija (schemas + hook + bloque de reglas) — cada número tiene un gate que rompe el build
si regresa (corpus fijo etiquetado + embedder determinista: pisos de regresión reproducibles,
no un leaderboard). Detalle · detail: 🇪🇸 cómo funciona ·
🇬🇧 how it works · evals/.
Y con modelos vivos (ronda 2026-07-21, Haiku 4.5 + Sonnet 5, datos crudos commiteados):
las 4 skills evaluadas rutean con 100% de acierto y 0% de falsos positivos (104 casos ES+EN; /vkm-verify, /vkm-intake y /vkm-ui-judge son posteriores al bench y todavía no están medidas);
el A/B pre-registrado del token-saver dio delta 0.0 de calidad con el log ~81% más
pequeño (veredicto: mantener — y la regla dice que un mecanismo que degrade se elimina);
/vkm-discipline sube a Haiku de 47.0 a 91.7 (+44.7) en la tarea subespecificada sin
tocar a Sonnet. Además un e2e smoke en CI prueba el stack entero por stdio real
(instalar → indexar → buscar → escribir → re-buscar) y la latencia por query está gateada
(p95 medido ~3 ms). Todo reproducible: evals/skills-triggering/ ·
evals/token-quality-ab/ · evals/discipline-bench/.
¿Vienes de 4.x? · Coming from 4.x?🇪🇸 Migración a 5.0 · 🇬🇧 5.0 migration — en Windows, cierra todas las sesiones del editor antes de ejecutar el instalador.
Libre uso con atribución visible obligatoria (base MIT) — ver LICENSE.md. No es
MIT estándar ni una licencia aprobada por la OSI: la cláusula de atribución visible obligatoria
queda fuera de la definición open source de la OSI. Por eso cada package.json la declara como
"license": "SEE LICENSE IN LICENSE.md" — ningún escáner debe clasificarla como MIT.
Belum ada daftar tool. Server remote mendapatkannya setelah pemeriksaan kesehatan pertama.
FAQ
Pertanyaan
Bagaimana cara menginstal Create Vkm Kit?
Salin konfigurasi stdio untuk Cursor, Claude Desktop, Claude Code, atau VS Code di halaman ini. Konfigurasi ini memakai instalasi dari penerbit, bukan proxy PlugMCP.
Apakah Create Vkm Kit memerlukan kunci API?
Tidak ada variabel lingkungan wajib yang tercantum di catatan ini.
Transport apa yang digunakan Create Vkm Kit?
Create Vkm Kit berjalan secara lokal melalui stdio.
Kapan Create Vkm Kit terakhir diperiksa?
Terakhir diperiksa 2026-10-28. Cross-platform kit that gives AI agents (Claude Code, Codex, Cursor) persistent memory: Markdown vault + git + MCP. Local-first, hybrid search optional.