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 proporcionada por tu versión instalada de lvl. Tú proporcionas el agente de codificación, el modelo y los tokens.

Necesitas:

Si planeas usar lvl con un agente de codificación, instala ese agente por separado. Level no aloja el modelo ni proporciona sus tokens.

Ejecuta el comando correspondiente a tu sistema operativo.

macOS o Linux:

Esto instala lvl a ~/.local/bin/lvl. Si ese directorio no está ya en tu PATH, el instalador lo agrega al archivo de inicio de tu shell. Reinicia tu shell o sigue el comando impreso por el instalador antes de continuar.

Windows (PowerShell):

Esto instala lvl.exe a %LOCALAPPDATA%\Programs\lvl y agrega ese directorio a tu PATH. Abre una nueva terminal si tu terminal actual no puede encontrar lvl después de la instalación.

El instalador detecta la arquitectura de tu procesador y verifica el archivo descargado y el ejecutable con los valores SHA-256 publicados.

Confirma que la CLI está disponible:

Ejecuta:

La CLI imprime un código de un solo uso y una URL de verificación, luego intenta abrir la URL en tu navegador.

Si el navegador no se abre, copia la URL impresa en un navegador en cualquier equipo.

Verifica la sesión activa:

Cierra sesión y elimina la sesión local:

De forma predeterminada, lvl busca una versión más nueva en segundo plano cuando ejecutas un comando, como máximo una vez por hora. Si hay una actualización disponible, el siguiente comando la instala y continúa con la nueva versión.

Busca e instala una actualización de inmediato:

Usa un ID de dispositivo siempre que sea posible. También puedes hacer referencia 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.

La mayoría de los comandos muestran una tabla de forma predeterminada. Usa JSON cuando otro programa necesite leer el resultado:

Usa el filtro jq integrado para seleccionar parte del resultado JSON:

Los comandos de lista devuelven hasta 100 resultados de forma predeterminada. Usa --limit para cambiar el número, o recupera todas las páginas:

Exporta los recursos compatibles como CSV redirigiendo la salida estándar a un archivo:

Ejecuta un script guardado en un dispositivo:

Ejecuta un comando sin guardar un script primero:

Puedes apuntar a más de un dispositivo con --device flags, o apunta a un grupo de dispositivos con --group.

Sin --wait, el comando devuelve los nuevos ID de ejecución después de que Level acepta la solicitud. Usa los comandos de ejecución para verificar el progreso y los resultados:

Para obtener detalles sobre scripts guardados, shells, tiempos de espera, variables, salida y códigos de salida, consulta Descripción general de scripts.

Exporta una automatización como YAML:

Previsualiza los cambios antes de aplicar el archivo:

Aplica la especificación:

El archivo describe el nombre de la automatización, los desencadenadores, las acciones y las variables. Puedes mantener el archivo en control de código fuente, revisar una diferencia y aplicarlo nuevamente después de realizar cambios.

Las especificaciones de automatización hacen referencia a recursos de la cuenta, como scripts, grupos, etiquetas, archivos y campos personalizados, mediante ID. Trata una especificación exportada como una instantánea para la misma cuenta de Level.

Para conocer los conceptos de automatización y el editor web, consulta Descripción general de automatizaciones y Crear automatizaciones.

Instala la habilidad generada por tu lvl versión:

El comando instala un archivo SKILL.md donde los agentes de codificación compatibles puedan descubrirla. Los ejemplos incluyen Cursor, Claude Code, Codex, Gemini, Hermes y OpenClaw.

Después de la instalación, puedes pedirle 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.

La habilidad de usuario predeterminada se actualiza automáticamente a medida que ejecutas lvl comandos, incluso después de que la CLI se actualice. No es necesario reinstalarla después de actualizar.

Muestra la habilidad generada sin instalarla:

Inspecciona los flags actuales y la estructura de salida JSON de un comando:

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, el historial de ejecución, los registros de actualización o la aplicación web de Level para confirmar el resultado final.

Muestra la lista de comandos de nivel superior:

Muestra la ayuda para un grupo de comandos o un comando:

La CLI instalada es la fuente de verdad para sus flags de comandos actuales y estructuras de salida. Usa lvl skill describe cuando necesites una referencia de comandos legible por máquina.