Referencia de CLI
Lizard CLI (lizard) despliega y gestiona apps, bases de datos y Sandboxes en Lizard (lizard.build) desde una terminal, un job de CI o un agente de programación. Esta página explica la instalación, las banderas globales, los códigos de salida y el descubrimiento en tiempo de ejecución. Cada comando tiene su propia página de referencia en la barra lateral: consulta lizard up, lizard service, lizard secrets y el resto. Para una visión general de lo que hace la CLI, consulta la página de Lizard CLI.
Referencia escrita para Lizard CLI v4.0.34. Ejecuta
lizard <cmd> --help --jsonpara obtener el esquema exacto de cualquier comando, correspondiente a tu versión.
Instalar y actualizar
curl -fsSL https://lizard.build/install.sh | bash # macOS and Linux
lizard --version
lizard upgrade # update to the latest version
lizard upgrade --check # check without installingConsulta lizard upgrade para ver las banderas.
En Windows, ejecuta irm https://lizard.build/api/cli/install.ps1 | iex en PowerShell. Con Node.js puedes instalar desde npm en su lugar: npm install -g @lizard-build/cli.
En macOS y Linux, el binario del script de instalación también se actualiza solo en segundo plano, como mucho una vez cada 6 horas. Omite la comprobación cuando CI o LIZARD_NO_UPDATE=1 están definidos. El binario de Windows no se actualiza solo: vuelve a ejecutar el instalador. Una instalación de npm se actualiza a través de npm: lizard upgrade muestra el comando.
Usa siempre el binario lizard instalado globalmente, no npx. Consulta Quickstart para corregir errores de permisos.
Autenticación
lizard login # browser OAuth
lizard login --token liz_xxx # API key auth
lizard logout
lizard whoami # current user, workspace, linked projectPáginas de referencia: lizard login, lizard logout, lizard whoami y lizard workspace para listar y crear workspaces.
Las claves de API empiezan por liz_. Crea una con lizard keys create <name>. En CI, configura LIZARD_TOKEN (o LIZARD_API_KEY) en el entorno en lugar de ejecutar login.
Banderas globales
| Bandera | Descripción |
|---|---|
-V, --version | Muestra la versión de la CLI |
--json | Salida legible por máquinas. Combínala con --help para volcar el esquema de un comando |
La mayoría de los comandos también aceptan -p, --project y -s, --service para apuntar a un recurso específico en lugar del enlazado. init, link y project también aceptan -w, --workspace. lizard add siempre usa el proyecto enlazado.
Códigos de salida
| Código | Significado | Qué hacer |
|---|---|---|
0 | éxito | continuar |
1 | error genérico | lee el mensaje |
2 | auth (401/403) | ejecuta lizard login |
3 | no encontrado (404) | comprueba el nombre con lizard ps / lizard project list |
4 | tiempo de espera agotado (408/504) | reintenta |
5 | cancelado por el usuario | detente |
Descubrimiento en tiempo de ejecución
La CLI se autodocumenta. Para ver el árbol completo de comandos, las banderas globales y los códigos de salida:
lizard --help --jsonPara ver los argumentos y opciones exactos de cualquier comando o subcomando:
lizard <cmd> --help --json
lizard <cmd> <sub> --help --json # e.g. lizard service set --help --jsonEsto siempre refleja tu versión instalada; úsalo para consultar la sintaxis de las banderas. También es como un agente aprende la CLI sin haber sido entrenado con ella: consulta despliegue desde Claude Code.
Configuración y estado
- La CLI almacena la autenticación y el enlace del proyecto del directorio actual en
~/.lizard/config.json. lizard statusmuestra el enlace de workspace/proyecto/servicio del cwd (no requiere autenticación).lizard linkestablece ese enlace,lizard unlinklo elimina ylizard projectlista, crea y elimina proyectos.lizard config applyaplica un archivolizard-config.jsona un proyecto (usa--dry-runpara previsualizar).lizard openabre el proyecto enlazado en el panel, ylizard docsabre esta documentación.
Variables de entorno
| Variable | Efecto |
|---|---|
LIZARD_TOKEN | Clave de API o token que se usa en lugar del inicio de sesión almacenado |
LIZARD_API_KEY | Igual que LIZARD_TOKEN |
LIZARD_API_URL | URL base de la API (por defecto https://lizard.build) |
LIZARD_HOME | Guarda el estado de la CLI en $LIZARD_HOME/.lizard en lugar de ~/.lizard |
LIZARD_NO_UPDATE | Desactiva la actualización automática en segundo plano |
CI | También desactiva la actualización automática en segundo plano |
LIZARD_SKILLS_DIR | Lee los skills de este directorio en lugar de los incluidos en la CLI |
Volúmenes de Sandbox
Gestiona Persistent Volumes por nombre dentro de un proyecto. Referencia completa: lizard volume y lizard sandbox.
lizard volume create agent-workdir --size 10 --project proj_123
lizard volume list --project proj_123
lizard volume resize agent-workdir --size 20 --project proj_123
lizard sandbox create --volume agent-workdir --project proj_123Los nombres son únicos por proyecto: letras minúsculas, números y guiones, hasta 64 caracteres; deben empezar y terminar con una letra o un número. Los volúmenes nuevos aceptan GB enteros de 1 a 50, con 5 por defecto. La CLI lee los límites actuales del servidor antes de crear el volumen y respeta los cambios de configuración. Los volúmenes existentes más grandes mantienen su tamaño.
Tras desconectar el volumen, lizard volume rm agent-workdir --project proj_123 lo elimina junto con sus datos. volume list muestra nombres; --json incluye los ID generados.
Actualizado