Level CLI, o lvl, te permite trabajar con tu cuenta de Level desde una terminal. Puedes inspeccionar dispositivos, actualizaciones, archivos, monitores, alertas, scripts, automatizaciones e historial de ejecución sin cambiar a la aplicación web de Level.
También puedes instalar la habilidad de Level para un agente de codificación. La habilidad enseña a los agentes compatibles cómo usar los comandos y la salida JSON proporcionados por la versión instalada de lvl. Tú proporcionas el agente de codificación, el modelo y los tokens.
ℹ️ NOTA: El lvl CLI gestiona tu cuenta de Level. Es independiente del agente de Level instalado en los dispositivos administrados.
Antes de comenzar
Necesitas:
Una cuenta de Level con acceso a la CLI.
Un equipo compatible con Windows, macOS o Linux en un procesador AMD64 o ARM64.
Un navegador que puedas usar para aprobar el inicio de sesión de la CLI.
Si planeas usar lvl con un agente de codificación, instala ese agente por separado. Level no aloja el modelo ni proporciona sus tokens.
Instalar la CLI
Abre la página de versiones de Level CLI. (Próximamente)
Descarga el archivo comprimido que coincida con tu sistema operativo y procesador:
windows-amd64owindows-arm64darwin-amd64odarwin-arm64para macOSlinux-amd64olinux-arm64
Compara el archivo descargado con el valor SHA-256 que aparece en
checksums.txten la versión.Extrae el archivo comprimido.
Renombra el ejecutable a
lvl(lvl.exeen Windows), luego muévelo a un directorio en tuPATH.Confirma que la CLI está disponible:
lvl --help
Iniciar sesión
Ejecuta:
lvl auth login
La CLI muestra un código de un solo uso y una URL de verificación, luego intenta abrir la URL en tu navegador.
Inicia sesión en Level en el navegador. Se siguen aplicando los requisitos habituales de SSO y MFA.
Confirma que el navegador muestra el mismo código de un solo uso que tu terminal.
Aprueba el acceso.
Regresa a la terminal. La CLI detecta la aprobación y completa el inicio de sesión.
Si el navegador no se abre, copia la URL mostrada en un navegador en cualquier equipo.
Verifica la sesión activa:
lvl auth status
Cierra sesión y elimina la sesión local:
lvl auth logout
Ejecuta tus primeros comandos
Listar dispositivos:
lvl device list
Listar actualizaciones de software disponibles:
lvl update list
Listar archivos del repositorio:
lvl file list
Listar monitores y políticas de monitor:
lvl monitor list
lvl monitor policy list
Listar alertas activas:
lvl alert list
Usa un ID de dispositivo cuando sea posible. También puedes referirte a un dispositivo por nombre de host, nombre, apodo o un nombre de host calificado por grupo, como Servers/web-01. Si un nombre coincide con más de un registro, lvl se detiene y solicita una referencia más específica en lugar de elegir una.
Elige un formato de salida
La mayoría de los comandos muestran una tabla de forma predeterminada. Usa JSON cuando otro programa necesite leer el resultado:
lvl device list -o json
Usa el filtro jq integrado para seleccionar parte del resultado JSON:
lvl device list --jq '.list[] | .name'
Los comandos de listado devuelven hasta 100 resultados de forma predeterminada. Usa --limit para cambiar el número, o recuperar todas las páginas:
lvl device list --limit 250
lvl device list --limit all
Exporta los recursos compatibles como CSV redirigiendo la salida estándar a un archivo:
lvl device export > devices.csv
lvl alert export --status resolved > resolved-alerts.csv
lvl run export --status error > failed-runs.csv
⚠️ ADVERTENCIA: La salida JSON de los comandos de clave de API puede contener el token completo. Protege los datos exportados y los registros de CI, y no confirmes credenciales en el control de versiones.
Ejecutar scripts
Ejecutar un script guardado en un dispositivo:
lvl script run "Check disk space" --device web-01 --wait
Ejecutar un comando sin guardar un script primero:
lvl script run --device web-01 --command 'hostname' --wait
Puedes apuntar a más de un dispositivo usando repetidamente los indicadores --device indicadores, o apunta a un grupo de dispositivos con --group.
Sin --wait, el comando devuelve los nuevos IDs de ejecución después de que Level acepta la solicitud. Usa los comandos de ejecución para verificar el progreso y los resultados:
lvl run list
lvl run get --wait
Para obtener detalles sobre scripts guardados, shells, tiempos de espera, variables, salida y códigos de salida, consulta Descripción general de scripts.
Gestionar automatizaciones como especificaciones
Exportar una automatización como YAML:
lvl automation spec "Patch Servers" --format yaml > patch-servers.yaml
Previsualizar cambios antes de aplicar el archivo:
lvl automation apply -f patch-servers.yaml --dry-run
Aplicar la especificación:
lvl automation apply -f patch-servers.yaml
El archivo describe el nombre de la automatización, los desencadenadores, las acciones y las variables. Puedes mantener el archivo en control de versiones, revisar un diff y aplicarlo nuevamente después de realizar cambios.
⚠️ ADVERTENCIA: Aplicar una especificación de automatización reconcilia la automatización activa con el archivo. Los desencadenadores o acciones existentes que falten en el archivo pueden eliminarse. Los cambios se aplican en secuencia, no como una sola transacción, por lo que un error puede dejar cambios anteriores aplicados. Ejecuta siempre --dry-run, revisa el plan y mantén una exportación actualizada antes de aplicar cambios.
Las especificaciones de automatización hacen referencia a recursos de la cuenta, como scripts, grupos, etiquetas, archivos y campos personalizados, por ID. Trata una especificación exportada como una instantánea para la misma cuenta de Level.
Para los conceptos de automatización y el editor web, consulta Descripción general de automatizaciones y Crear automatizaciones.
Usar lvl con un agente de codificación
Instala la habilidad generada por tu lvl versión:
lvl skill install
El comando instala un SKILL.md archivo donde los agentes de codificación compatibles puedan detectarlo. Algunos ejemplos son Cursor, Claude Code, Codex, Gemini, Hermes y OpenClaw.
Tras la instalación, puedes pedir a tu agente de codificación que inspeccione tu flota a través de lvl, redactar un script o redactar una especificación de automatización. Revisa cada comando y archivo propuesto antes de ejecutarlo o aplicarlo.
Reinstala la habilidad después de actualizar lvl para que su índice de comandos y las definiciones de salida coincidan con la versión instalada:
lvl skill install
Muestra la habilidad generada sin instalarla:
lvl skill show
Inspecciona los indicadores actuales y la forma de salida JSON de un comando:
lvl skill describe device list
lvl skill describe automation action add
ℹ️ NOTA: Instalar la habilidad no instala un agente de codificación ni conecta Level a un proveedor de LLM. Tú eliges y configuras el agente de codificación, el modelo y los tokens.
Confirmar cambios y verificar la finalización
Los comandos que eliminan recursos de forma permanente admiten --yes. En una terminal interactiva, lvl solicita confirmación antes de estos cambios. En una sesión no interactiva, como CI, los comandos que requieren confirmación fallan a menos que proporciones --yes.
Algunos comandos solicitan trabajo asíncrono y regresan antes de que el dispositivo lo complete. Estos incluyen reinicio, apagado, verificaciones de actualización, instalación de actualizaciones, scripts y automatizaciones. Usa lvl run get <run-id> --wait, historial de ejecución, registros de actualización o la aplicación web de Level para confirmar el resultado final.
⚠️ ADVERTENCIA: Trata las claves de instalación, los tokens de API, el inventario exportado, la salida de scripts y los archivos de automatización como información sensible. Evita mostrarlos en terminales compartidas o registros de CI.
Obtener ayuda sobre comandos
Muestra la lista de comandos de nivel superior:
lvl --help
Muestra la ayuda para un grupo de comandos o un comando:
lvl device --help
lvl script run --help
lvl automation apply --help
La CLI instalada es la fuente de verdad para sus indicadores de comandos actuales y las formas de salida. Usa lvl skill describe cuando necesites una referencia de comandos legible por máquina.