offstage

Cada sandbox en Apple silicon corre macOS 27 como una cuenta de usuario con su propio directorio y sus procesos. Lo manejas llamada a llamada: ejecutas un comando en zsh, escribes un archivo de hasta 10 MiB, lo lees como texto o en bytes. El resto de trabajos del Mac Studio no ve tus archivos.

sandbox.commands.run() lanza el comando dentro de zsh -lc y devuelve stdout, stderr, el código de salida y la duración. Un código distinto de cero no lanza excepción, así que un test fallido es un resultado normal sobre el que puedes decidir. Los comandos largos se siguen hasta 30 minutos.

Un sandbox headless arranca directo en una shell, lo que encaja con compilaciones y scripts. Un sandbox gui vive dentro de una sesión de escritorio iniciada, para apps con ventana y capturas de pantalla. No hay API de clics ni de tecleo: mueves la interfaz con un programa que corre en el Mac.

Conectas tu organización de GitHub en la consola y pones runs-on: offstage-macos en el workflow. Cada trabajo recibe una cuenta nueva, el runner de GitHub ejecuta ese trabajo y la cuenta se borra al acabar. Cambia a offstage-macos-gui cuando el trabajo necesite el escritorio para pruebas de interfaz en el simulador.

Una tarea clona la rama por defecto de un repositorio público, ejecuta tu comando y guarda los artefactos que indiques. El campo failureReason separa una compilación rota de un clon fallido, un timeout o una máquina que nunca llegó. Esperar en la cola no cuesta nada.

Cada sandbox y cada tarea cuesta $0.000217 por segundo, o $0.78 por hora, sin mínimo y sin licencias por usuario. Los equipos nuevos empiezan con $5 de crédito y un presupuesto mensual de $50 que el propietario sube o elimina en la consola, con avisos al 50%, 80% y 100%.