Sandbox

Also for this capability: API · CLI · MCP · SDKs

The ONE compute primitive: a sandbox is a gVisor pod that runs somebody else's code, and every lifetime is the same object.

API reference →

hanzo sandbox list

Every command takes --json for the raw response and --help for its own flags. Sign in once with hanzo auth login; the commands below use that session, and the org they act in is the one it carries.

Command	What it does
`hanzo sandbox create`	Leases a sandbox — a real computer — for the caller's org.
`hanzo sandbox end`	End a sandbox and release it
`hanzo sandbox lease`	Lease a sandbox — a real computer — or resume one you hold
`hanzo sandbox list`	Lists the caller org's sandboxes, newest first.
`hanzo sandbox read`	Read a file from a sandbox you hold
`hanzo sandbox run`	Run a command in a sandbox you hold and read its output
`hanzo sandbox stop`	Stop what a sandbox is running, and keep the sandbox
`hanzo sandbox write`	Write a file into a sandbox you hold

exec

Command	What it does
`hanzo sandbox exec <id>`	Runs one command in a sandbox the caller holds and answers with its exit code, stdout and stderr.

fs

Command	What it does
`hanzo sandbox fs create <id>`	Write a file
`hanzo sandbox fs get <id>`	Read a file, or list a directory

get

Command	What it does
`hanzo sandbox get <id>`	Returns one sandbox: its class, project, image, the runtime it was given, its status and when its lease ends.

rm

Command	What it does
`hanzo sandbox rm <id>`	Ends a sandbox and releases the compute behind it.

screen

Command	What it does
`hanzo sandbox screen get <id>`	The screen, as a page
`hanzo sandbox screen ticket <id>`	Mints a short-lived grant to open the screen of a desktop sandbox.
`hanzo sandbox screen ws <id>`	The screen, as a socket

terminal

Command	What it does
`hanzo sandbox terminal get <id>`	The terminal, as a page
`hanzo sandbox terminal ticket <id>`	Mints a short-lived grant to open a terminal on a sandbox.
`hanzo sandbox terminal ws <id>`	The terminal, as a socket

exec

fs

get

rm

screen

terminal

On this page