Quickstart en 5 minutos

De máquina limpia a tu primera sesión IA leyendo del vault persistente, en cinco minutos. Tres comandos instalan Korva, tres más conectan tus editores y arrancan el vault.

Actualizado: 2026-05-15

Esta guía te lleva de cero a tu primera sesión IA con vault persistente.

1. Instala (30 segundos)

curl -fsSL https://korva.dev/install | bash

Ver Instalación para Homebrew / PowerShell / Docker.

2. Inicializa el workspace

korva init
# Si vas a administrar este equipo:
korva init --admin --owner [email protected]

Crea ~/.korva/ con install.id, hive.key y un config.json por defecto. Con --admin también genera ~/.korva/admin.key (modo 0600).

3. Arranca el vault

korva vault start

Escucha en http://localhost:7437 (REST) y stdio (MCP).

4. Conecta tus editores

korva setup --all

Detecta cada IDE soportado (Claude Code, Cursor, Windsurf, Copilot, Codex, OpenCode, Gemini, VS Code) y escribe la config MCP. Para uno específico: korva setup claude-code.

5. Verifica

korva doctor
korva status

Ambos deberían imprimir All checks passed.

6. Primera sesión IA

Abre cualquier editor conectado. La IA llama vault_context automáticamente y carga decisiones recientes. Para guardar lo que aprendió:

Guarda esta decisión arquitectónica sobre claves de idempotencia en el vault.

La IA llama vault_save por ti. Seis meses después, cuando alguien abra el mismo archivo, esa decisión reaparece.

7. Conecta al portal Teams (opcional)

Si tu organización usa el tier Teams de Korva:

korva connect https://portal.korva.dev K0RVA-XXXX-XXXX-XXXX-XXXX

Sustituye la URL y la clave por las que te dé tu admin de equipo. Activa skills compartidas, scrolls privados y analíticas de equipo.

8. Bloquea malos commits

korva sentinel install

Instala dos hooks Git en este repo:

pre-commit — bloquea violaciones de arquitectura
post-commit — corre korva sync --vault --quiet (best-effort)

Próximos pasos

¿Detalle completo? Quickstart en inglés.