Computer reference
Full detail on resources, lifecycle, filesystem, shell, browser, snapshots, networking, limits, and billing.
The micro-VM
A full Linux userland with configurable vCPU, memory, and disk — code, browser control, native binaries, daemons — paused between turns for near-zero idle cost.Create a computer
Resources are optional — omit them and the computer provisions at the default 2 vCPU / 4 GiB.
What the agent can do
Inside a session, the agent reaches the computer through built-in tools:Pause, resume, snapshot
A paused computer bills nothing and resumes with its filesystem intact. Disk is never metered. Pausing a computer you created does not refund the rest of its 10-minute block already paid, and any exec, fs, snapshot or execStream call on a paused computer resumes it, so billing restarts.Coming soon: a fully virtualized V8 isolate mode (
mode: "isolate") with near-instant boot and near-zero idle, and vault secret injection on all sandbox egress (live on the MCP connector path today).Fields
integer
default:"2"
Provisioned vCPU (1–16).
integer
default:"4096"
Provisioned memory in MiB (128–65536).
integer
Root disk size in whole GiB (up to 100).
object | null
default:"null"
Attach a managed browser with its options;
{} alone reaches the open web unless allowed_domains scopes it.snapshot_id, is in the Computer reference.
Next: identity
Give the agent an addressable persona.