levante-cli

CLI de Levante Platform (binario levante). Gestiona las skills y los MCP privados de tu organización desde la terminal, e instálalos en tus agentes de código (Claude Code, Codex, …).

Instalación

npm i -g levante-cli
# o sin instalar:
npx levante-cli whoami

Requiere Node ≥ 20.

Primer uso

Al instalar el CLI y ejecutar tu primer comando interactivo, levante intenta instalar automáticamente su skill compañera (levante-cli) en los agentes de código que detecte. También puedes hacerlo de forma explícita:

levante init                          # detecta agentes e instala la skill compañera
levante init --agents claude-code,codex
levante init --project                # solo en el proyecto actual (por defecto: global)

En contextos no interactivos (sin TTY o con --json) el arranque automático se omite; ejecuta levante init explícitamente.

Autenticación

levante login            # inicia sesión vía OAuth en el navegador
levante login --no-browser   # imprime la URL en vez de abrir el navegador
levante whoami           # (alias: status) muestra usuario/org/team de la sesión
levante logout           # borra las credenciales locales

Skills (alias: sk)

levante skills add [slugs...]      # (a|i|install) descarga e instala skills
levante skills list                # (ls) skills instaladas localmente
levante skills available           # (av|remote) catálogo remoto de tu organización
levante skills remove [slugs...]   # (rm|r) desinstala
levante skills update [slugs...]   # (upgrade) re-descarga versiones nuevas
levante skills push [slugs...]     # (publish) sube tus correcciones a la plataforma

MCPs privados de la organización

levante mcp add [slugs...]         # (a|i|install) instala MCPs de la org en tus agentes
levante mcp list                   # (ls) MCPs instalados localmente
levante mcp available              # (av|remote) MCPs desplegados en tu organización
levante mcp remove [slugs...]      # (rm|r) quita MCPs de la config de tus agentes
levante mcp redeploy <slug>        # (deploy) redespliega aplicando cambios pendientes
levante mcp status <slug>          # (st) estado y progreso de despliegue

# Variables de entorno de un MCP (nunca se imprime el valor):
levante mcp env list <slug>        # (ls) lista solo las claves
levante mcp env set <slug> KEY=VALUE [KEY...]   # crea/actualiza (--redeploy para aplicar)
levante mcp env rm <slug> [keys...]             # marca para borrar (--redeploy para aplicar)

Flags globales

--env <prod|local>   entorno (default: prod → https://platform.levanteapp.com)
--json               salida JSON estructurada para scripting
--verbose            logs de depuración (sin exponer tokens)

También: LEVANTE_API_URL para apuntar a un base URL arbitrario (si es localhost/127.0.0.1 el namespace de credenciales pasa a local).

Desarrollo

bun install
bun turbo build --filter=levante-cli
bun turbo test --filter=levante-cli
bun turbo lint --filter=levante-cli
bun turbo check-types --filter=levante-cli

El binario se construye con tsup en dist/index.js (bundle ESM único; @napi-rs/keyring queda como dependencia nativa externa). La skill compañera canónica vive versionada en skill/ y se empaqueta a dist/skill/ durante el build.