Comandos de la CLI

La CLI korva es el orquestador de todo — inicializa workspaces, gestiona editores, ejecuta sentinel, activa licencias, gestiona equipos, sincroniza skills y opera el vault. Construida con Cobra, funciona donde sea que el binario funcione.

Actualizado: 2026-05-15

La CLI korva es tu interfaz principal con todo Korva. Es un único binario Cobra que viene con la instalación. Ejecuta korva --help para ver el árbol en vivo.

Comandos de ciclo de vida

Comando	Propósito
`korva init`	Inicializa `~/.korva/`, genera IDs, escribe el `korva.config.json` por proyecto. Añade `--admin --owner [email protected]` para generar también `admin.key`.
`korva setup [editor]`	Auto-configura MCP para uno o cada IDE soportado. Idempotente. Usa `--all` para hacerlos todos de una vez.
`korva status`	Snapshot de la instalación actual — vault corriendo, tier de licencia, número de proyectos, última sincronización.
`korva doctor`	13+ chequeos de salud. Úsalo después de instalar o cuando algo se sienta raro.
`korva update`	Auto-actualización descargando el último release de GitHub, verificando SHA256 y reemplazando binarios atómicamente.

Servidor del Vault

Comando	Propósito
`korva vault start`	Arranca `korva-vault` en background, escribe el PID, hace polling de `/healthz` hasta que esté disponible (timeout 5 s).
`korva vault stop`	Envía SIGINT al PID, elimina `vault.pid`.
`korva vault status`	Estado del proceso + alcanzabilidad HTTP.
`korva vault logs`	Imprime la ruta a `vault.log` para `tail -f`.
`korva vault clean [--dry-run] [--project NAME]`	Deduplica observaciones usando `GROUP BY (project, type, lower(trim(content)))`, conserva la más antigua. Funciona sin necesidad de que el servidor esté corriendo.

Sentinel

Comando	Propósito
`korva sentinel install`	Instala los hooks de Git pre-commit + post-commit en el repo actual.
`korva sentinel check`	Ejecuta el validador sobre los archivos staged sin hacer commit.
`korva sentinel run --hook=pre-commit`	Interno — invocado por el propio hook de Git.

Conexión al portal Teams

Comando	Propósito
`korva connect <url> <key>`	Conecta esta estación de trabajo al portal Korva Teams de tu organización. Almacena el endpoint y autentica con la clave de licencia proporcionada. Activa skills compartidas, scrolls privados y analíticas de equipo.
`korva connect --status`	Muestra el estado de conexión actual, URL del portal y tier.
`korva connect --disconnect`	Elimina la conexión al portal almacenada (los datos locales no se borran).

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

Licencia

Comando	Propósito
`korva license activate <key>`	POST al endpoint de licencias, verifica el token JWS RS256, persiste a `~/.korva/license.key` (modo 0600), inicia el heartbeat de 24 h.
`korva license status`	Tier, expiración, último heartbeat, gracia restante.
`korva license deactivate`	Libera el asiento (vuelve al tier Community, sin borrar datos).

Admin (requiere admin.key)

Comando	Propósito
`korva admin init`	Bootstrap de admin.key en una instalación nueva.
`korva admin rotate-key`	Rota admin.key (la clave actual se requiere por stdin por seguridad).

Lore

Comando	Propósito
`korva lore list`	Muestra los scrolls instalados — curados y de equipo.
`korva lore add`	Autoría interactiva de scrolls (plantilla, frontmatter, triggers).

Teams (requiere admin.key)

Comando	Propósito
`korva teams sync`	Pull del perfil de equipo desde su repo Git privado.
`korva teams status`	Perfil activo + resumen de overrides.
`korva teams list`	Lista los equipos gestionados en esta instancia.
`korva teams create "<name>" --owner <email>`	Crea un equipo.
`korva teams members <team_id>`	Lista miembros.
`korva teams invite <email> --team <team_id>`	Genera un token de invitación (mostrado una vez).
`korva teams add-member <team_id> <email> [--role admin]`	Promueve / añade directamente.
`korva teams remove-member <team_id> <email>`	Revoca la membresía.

Auth (miembros del equipo)

Comando	Propósito
`korva auth redeem <invite-token>`	Canjea un token de invitación por un `session_token`, persistido en `~/.korva/session.token` (modo 0600).
`korva auth status`	Muestra la identidad de la sesión actual.
`korva auth logout`	Borra el token de sesión localmente y lo revoca en remoto.

Hive

Comando	Propósito
`korva hive push`	Vacía el outbox local una vez.
`korva hive status`	Conteos de pendientes / enviados / rechazados / fallidos + estado del worker.
`korva hive enable / disable`	Activa o desactiva la sincronización (escribe config).
`korva hive retry`	Re-encola filas en estado `failed`.
`korva hive rotate-key`	Genera una nueva API key de Hive de 32 bytes.

Sync

Comando	Propósito
`korva sync`	Combinado: pull del perfil de equipo + flush del outbox del vault + sync de skills. Usa los flags `--vault`, `--profile`, `--skills` para acotar el alcance.
`korva sync --vault --quiet`	Usado por el hook post-commit de Git.

Observaciones (acceso CLI al vault)

Comando	Propósito
`korva obs list [--project] [--type] [--limit]`	Lista observaciones.
`korva obs search <query> [--cloud]`	Búsqueda full-text (opcionalmente incluyendo Hive).
`korva obs get <id>`	Imprime una por ULID.

Skills

Comando	Propósito
`korva skills list`	Lista los skills distribuidos por el equipo.
`korva skills sync`	Pull de skills actualizados desde `/team/skills/sync` (delta).
`korva skills history <id>`	Muestra el historial de versiones del skill.
`korva skills hook install`	Añade un hook `PreToolUse` en `~/.claude/settings.json` para que Claude Code sincronice skills automáticamente antes de cada sesión.
`korva skills hook remove`	Quita el hook de sincronización automática.

Chequeo de auto-actualización

Cada comando hace un chequeo oportunista y no bloqueante de releases en GitHub en su primera invocación cada 24 h. Define KORVA_NO_UPDATE_CHECK=1 para deshabilitarlo.