vetta computer - Naive

Manage computers — disposable Linux sandboxes with an optional browser.

Commands

Command	Description
`vetta computer create`	Create a computer.
`vetta computer list`	List computers.
`vetta computer show <id>`	Show a computer.
`vetta computer exec <id>`	Run a shell command.
`vetta computer pause <id>`	Park the sandbox (storage-only cost).
`vetta computer resume <id>`	Wake the sandbox.
`vetta computer snapshot <id>`	Capture state to boot from later.
`vetta computer delete <id>`	Destroy the sandbox.

create

vetta computer create --name box --vcpu 2 --memory-mb 4096 --browser --allowed-domains "*.example.com"

Flag	Description
`--name`	Human-readable name (required).
`--vcpu`	Provisioned vCPU, 1–16 (default 2).
`--memory-mb`	Provisioned memory in MiB, 128–65536 (default 4096).
`--disk-gb`	Root disk size in GiB (up to 100).
`--mode`	`isolate` coming soon (Phase 5). Today every computer is a micro-VM (`vm`).
`--size`	Optional preset (`small` \| `medium` \| `large`). Not available yet — no preset is defined, so passing it is an error; set `--vcpu`, `--memory-mb` and `--disk-gb`.
`--browser`	Attach a managed browser.
`--allowed-domains`	Required with `--browser`; comma-separated globs, or `*`.
`--volume <id>`	Attach a persistent volume.
`--snapshot <id>`	Boot from a snapshot.

exec, pause, resume, snapshot

vetta computer exec box -- "ls -la /workspace"
vetta computer pause box
vetta computer resume box
vetta computer snapshot box

Snapshots take no --name: the call returns a snapshot_id, and that id is the handle you pass to vetta computer create --snapshot. Passing --name is a hard error, not an ignored flag.

Computers pause automatically when the agent sleeps between turns, so you rarely pause manually. See Runtime & durability.

fs

One command covers the whole filesystem surface. The operation comes first, then the computer: vetta computer fs <read|write|list|mkdir|remove> <computer-id> --path <path>.

vetta computer fs list cmp_01a02ad8ba0f7bd59115bfd513fc6ed7 --path /etc

{
  "entries": [
    { "name": ".pwd.lock", "type": "file" },
    { "name": "X11", "type": "dir" }
  ]
}

vetta computer fs read cmp_01a02ad8ba0f7bd59115bfd513fc6ed7 --path /etc/hostname

{
  "path": "/etc/hostname",
  "encoding": "text",
  "content": "eager-falcon-96c0\n"
}

write takes --content, and --encoding base64 carries bytes that are not text. remove and mkdir take only --path. Passing the computer id where the operation belongs is a usage error, not a request:

usage: fs op must be read|write|list|mkdir|remove, got "cmp_01a02ad8ba0f7bd59115bfd513fc6ed7"