lizard sandbox
Crea y gestiona Sandboxes desde la terminal. Alias: lizard sb.
Uso
lizard sandbox create [flags]
lizard sandbox list [flags]
lizard sandbox exec <id> -- <command>
lizard sandbox ssh <id>
lizard sandbox fork <id> [flags]
lizard sandbox rm <id> [flags]Cada sandbox pertenece a un proyecto: el que indiques con -p; si no, el vinculado al directorio actual; y si no, el proyecto predeterminado de tu cuenta (el proyecto más antiguo de tu espacio de trabajo personal).
Subcomandos
lizard sandbox create
Crea un sandbox y muestra su ID.
| Bandera | Descripción |
|---|---|
-t, --template <name> | Plantilla (por defecto base). Plantillas habilitadas: base, interpreter, codex, desktop, desktop-camoufox (solo en US East), opencode, pi, prime, claude. El servidor comprueba la lista de la región |
-s, --size <size> | mini, small, medium (por defecto; small durante la prueba) o large. mini solo funciona con las plantillas base, claude, codex e interpreter, sin volumen |
--timeout <ms> | Duración en milisegundos (por defecto 300000, cinco minutos); 0 desactiva la caducidad. Durante la prueba, como máximo 3600000 (1 hora), y 0 da 1 hora |
--region <code> | Región donde crear el sandbox |
--snapshot <id> | Partir de un snapshot guardado; no se puede combinar con --size |
--volume <name-or-id> | Conectar un Persistent Volume |
--with-token [key] | Iniciar sesión en lizard dentro del sandbox con una clave nueva limitada al proyecto del sandbox y que se elimina con el sandbox. La clave liz_ que pases o, sin valor, la clave liz_ con la que ejecutas el comando solo autoriza la solicitud; un inicio de sesión desde el navegador no tiene ninguna. La plantilla base no incluye lizard |
-p, --project <id> | Proyecto (por defecto, el vinculado; si no, tu proyecto predeterminado) |
Lizard factura cada tamaño por segundo con una tarifa fija mientras el sandbox está en marcha, incluido el tiempo inactivo. El precio incluye el disco local y 2 TB de tráfico saliente por cuenta durante los últimos 30 días. Una pausa completada detiene los cargos de cómputo; el almacenamiento en Persistent Volumes mantiene la tarifa de volúmenes, tanto si el volumen está conectado como si no.
| Tamaño | vCPU | Memoria | Disco | Precio |
|---|---|---|---|---|
small | 2 | 4 GiB | 20 GB | $0.0162/h |
medium | 4 | 8 GiB | 40 GB | $0.0324/h |
large | 8 | 16 GiB | 80 GB | $0.0648/h |
Cualquier proceso dentro del sandbox puede leer la clave que instala --with-token y usarla en el proyecto del sandbox hasta que se elimine el sandbox.
Hasta que empiece tu prueba o tu plan, create devuelve HTTP 402 con un enlace de Checkout; ejecuta lizard billing start. Los límites cuentan las vCPU de los sandboxes en marcha: 40 en Pro después de la primera factura pagada, 220 en Pro 5x y 1,200 en Pro 20x. Pro 5x y Pro 20x no tienen límite de inicios de sandbox. Los sandboxes en pausa no cuentan. Durante la prueba, un sandbox se ejecuta en una región de EE. UU. y es small o mini, con 1 Small y 2 Mini a la vez. Un segundo small o un tercer mini en ejecución a la vez, tanto si lo creas como si haces fork de él o lo reanudas, devuelve HTTP 403 con TRIAL_SIZE_RUNNING; pausa o elimina uno, o inicia un mini en lugar de un small. medium devuelve HTTP 403 con TRIAL_SANDBOX_SIZE, large devuelve HTTP 403 con SANDBOX_SIZE_NOT_ALLOWED, y otra región devuelve HTTP 403 con TRIAL_SANDBOX_REGION. Por encima del límite de vCPU, create devuelve HTTP 429 con SANDBOX_LIMIT_REACHED. Consulta Límites. Un sandbox de prueba se elimina como máximo 1 hora después de iniciarse: sin --timeout (o con 0) recibe 1 hora, y un --timeout mayor que 3600000 devuelve HTTP 403 con TRIAL_SANDBOX_LIFETIME.
lizard sandbox list
Lista los sandboxes del proyecto vinculado (alias ls).
| Bandera | Descripción |
|---|---|
-p, --project <id> | Listar este proyecto en su lugar |
--all | Listar todos los sandboxes de todos tus espacios de trabajo |
lizard sandbox rm <id>
Elimina un sandbox (alias delete y kill).
| Bandera | Descripción |
|---|---|
-y, --yes | Omitir la confirmación |
lizard sandbox timeout <id> <ms>
Fija una nueva duración, contada desde ahora, en milisegundos (al menos 1000). No es un temporizador de inactividad: ejecutar comandos no lo reinicia. Durante la prueba, el plazo no puede pasar de 1 hora después de crear el sandbox; uno posterior devuelve HTTP 403 con TRIAL_SANDBOX_LIFETIME y latestExpiresAt.
lizard sandbox exec <id> -- <command>
Ejecuta un comando dentro del sandbox mediante sh -c, transmite su salida y termina con su código de salida.
lizard sandbox ssh <id>
Abre una shell interactiva en un sandbox en ejecución (alias shell). Usa tu sesión de Lizard, así que no hay claves SSH que configurar; una clave de API con ámbito solo llega a los sandboxes de su ámbito. Ctrl-C, las flechas y el autocompletado con tabulador van al sandbox. Escribe exit o pulsa Ctrl-D para salir.
Necesita una terminal interactiva; en un script, usa lizard sandbox exec. No es el protocolo SSH, así que los clientes SSH, scp y el reenvío de puertos no funcionan.
lizard sandbox expose <id> <port>
Asigna una URL HTTPS a un puerto del sandbox. El puerto es privado: las solicitudes necesitan el token de acceso del sandbox, ya sea en la cabecera X-Lizard-Access-Token o como el parámetro de consulta lizard_token, que la URL mostrada ya incluye. Las solicitudes sin él reciben HTTP 401. Con --json, el resultado también incluye hostname y accessToken.
lizard sandbox unexpose <id> <port> elimina la URL.
lizard sandbox desktop <id>
Inicia el escritorio gráfico de un sandbox creado con -t desktop y muestra su URL para el navegador y una URL de solo visualización. Trata ambos enlaces como contraseñas.
| Bandera | Descripción |
|---|---|
--view-only | Mostrar o abrir únicamente la URL de solo visualización |
--resolution <WxH> | Tamaño de pantalla, de 640x480 a 3840x2160 |
--open | Abrir el escritorio en el navegador |
--status | Mostrar el estado y las URL del escritorio sin iniciarlo |
--stop | Detener el escritorio y eliminar su URL |
lizard sandbox vnc <id>
Conecta una app VNC (Compartir Pantalla de macOS, TigerVNC, RealVNC) al escritorio de un sandbox creado con -t desktop. El escritorio no tiene un puerto VNC público, así que la CLI escucha en localhost y lleva cada conexión al sandbox a través de un WebSocket seguro. Inicia el escritorio si hace falta, muestra la dirección y la contraseña VNC, y sigue en marcha hasta que pulses Ctrl-C.
| Bandera | Descripción |
|---|---|
--port <port> | Puerto local (por defecto 5900; si está ocupado, el siguiente libre) |
--view-only | Usar la contraseña de solo visualización: ver, sin controlar |
--open | Abrir la dirección en tu app VNC (vnc://, Compartir Pantalla en macOS) |
Pausa, reanudación y snapshots
| Comando | Qué hace |
|---|---|
lizard sandbox pause <id> | Guarda la memoria y los procesos y pausa el sandbox. Una pausa completada detiene los cargos de cómputo; el almacenamiento en Persistent Volumes se cobra aparte |
lizard sandbox pause <id> --fast | Pausa en alrededor de un segundo conservando solo los archivos: la memoria no se guarda, los procesos en ejecución terminan y resume arranca el sandbox de nuevo con sus archivos |
lizard sandbox resume <id> | Vuelve a iniciar un sandbox en pausa con su memoria y sus archivos guardados |
lizard sandbox snapshot <id> --name <name> | Guarda un sandbox en ejecución, con su memoria y sus archivos, como un snapshot que solo se restaura en el proyecto y la región del sandbox |
lizard sandbox restore <snapshot-id> | Inicia un sandbox nuevo desde un snapshot, en el proyecto y la región del snapshot. --volume <name-or-id> monta en /workspace un volumen de ese proyecto y --timeout <ms> fija la duración (por defecto 300000) |
lizard sandbox snapshots | Lista los snapshots tomados en el proyecto (-p para otro proyecto, --mine para todos los snapshots que tomaste) |
lizard sandbox snapshot-rm <snapshot-id> | Elimina un snapshot (alias snapshot-delete; -y omite la confirmación) |
pause, resume y snapshot esperan hasta que termina el trabajo; pasa --no-wait para volver en cuanto quede en cola. Consulta Pausa, reanudación y snapshots para ver qué conserva cada paso.
Un snapshot de un sandbox con un volumen conectado incluye una copia de los archivos del volumen tal como estaban al capturar. Cada restauración recibe esa copia y no acepta --volume, y cualquiera que pueda restaurar el snapshot puede leer esos archivos. --volume solo funciona con un snapshot de un sandbox que no tenía volumen, y el volumen debe estar en el proyecto y la región del snapshot.
lizard sandbox fork <id>
Inicia copias en vivo de un sandbox en ejecución. Lizard pausa el sandbox un momento, captura una vez su memoria, sus procesos y sus archivos, y arranca cada copia desde esa captura. El original sigue en ejecución con el mismo ID y la misma duración. Prepara un sandbox (herramientas instaladas, app cargada) y luego haz fork para repartir el trabajo entre copias sin repetir la preparación.
| Bandera | Descripción |
|---|---|
-n, --count <n> | Copias que iniciar, de 1 a 100 (por defecto 1) |
--timeout <ms> | Duración de cada copia, al menos 1000; por defecto, la duración del original |
Cada copia es un inicio de sandbox: cuenta para los límites de sandboxes en ejecución y de inicios, se ejecuta con el tamaño del original y se factura según ese tamaño. Con --json, la salida tiene una entrada por copia: {"sandbox": {...}} o {"error": "..."}. Si alguna copia no pudo iniciarse, el comando sale con 1, y las copias que sí se iniciaron siguen en ejecución hasta que las elimines. No puedes hacer fork de un sandbox pausado ni de uno con un volumen conectado (HTTP 409).
lizard sandbox files
| Comando | Qué hace |
|---|---|
lizard sandbox files ls <id> [path] | Lista un directorio (por defecto /) |
lizard sandbox files cat <id> <path> | Muestra un archivo |
lizard sandbox files put <id> <local> <remote> | Sube un archivo local |
lizard sandbox files get <id> <remote> <local> | Descarga un archivo |
lizard sandbox files rm <id> <path> | Elimina un archivo o un directorio |
Agentes de programación
Ejecuta un agente de programación dentro de un sandbox con tus propias credenciales. Conéctalas antes con lizard agents. Crea el sandbox desde una plantilla de agente (codex, claude, opencode, pi o prime); la plantilla base no tiene Node.js y no puede ejecutar agentes.
lizard sandbox prompt <id> <prompt...> envía un prompt y transmite lo que hace el agente.
| Bandera | Descripción |
|---|---|
--agent <name> | codex (por defecto), claude, pi, opencode o prime |
-c, --conversation <id> | Continuar esta conversación |
--new | Iniciar una conversación nueva |
-m, --model <model> | Modelo que se usará |
--effort <level> | Esfuerzo de razonamiento: minimal, low, medium, high o xhigh |
--cwd <dir> | Directorio de trabajo en el sandbox (por defecto /workspace) |
-v, --verbose | Mostrar también la salida de los comandos |
--no-wait | Volver en cuanto se acepte el prompt |
Ctrl-C deja de mostrar la actividad; el agente sigue trabajando. lizard sandbox interrupt <id> [-c <conversation>] detiene su turno en curso. lizard sandbox conversations <id> lista las conversaciones, de la más reciente a la más antigua.
Ejemplos
Crear un sandbox y ejecutar un comando
lizard sandbox create --size small --timeout 600000
lizard sandbox exec genuine-toddler-jasj -- python3 -c "print(1 + 1)"Abrir una shell
lizard sandbox ssh genuine-toddler-jasjConectar un Persistent Volume
lizard volume create agent-workdir --size 10
lizard sandbox create --volume agent-workdirServir un puerto
lizard sandbox exec genuine-toddler-jasj -- sh -c "nohup python3 -m http.server 3000 --bind 0.0.0.0 >/tmp/http.log 2>&1 &"
lizard sandbox expose genuine-toddler-jasj 3000Usar un escritorio desde una app VNC
lizard sandbox create -t desktop
lizard sandbox vnc genuine-toddler-jasj --openEjecutar Codex en un sandbox
lizard agents login chatgpt
lizard sandbox create -t codex
lizard sandbox prompt genuine-toddler-jasj "add a health check endpoint and test it"Guardar y restaurar un sandbox
lizard sandbox snapshot genuine-toddler-jasj --name my-app
lizard sandbox snapshots --mine # find the snapshot ID
lizard sandbox restore <snapshot-id>Hacer fork de un sandbox preparado
lizard sandbox fork genuine-toddler-jasj -n 8 --json # 8 copies with the same memory and files
lizard sandbox rm <copy-id> # delete a copy when its work is doneVéase también
- Sandboxes — runtime, plantillas y ciclo de vida
- Inicio rápido de Sandboxes — los mismos pasos desde Lizard SDK
- lizard volume — Persistent Volumes para conectar con
--volume - lizard agents — credenciales para
sandbox prompt - Límites — tamaños, límites de ejecución, tráfico saliente y duración
Actualizado