vm_create
Creates an isolated Ubuntu sandbox with Chrome, VNC, and xfce4 for AI computer tasks. Supports resuming from saved snapshots. Returns a sandbox ID and noVNC URL to monitor activity.
Instructions
Create a new sandbox (isolated Ubuntu mini-computer with shell, Chrome + CDP, VNC, xfce4). IMPORTANT: Before creating, check if the user has saved snapshots by looking at the available_snapshots field in the response. If snapshots exist, ask the user whether they want to resume from a snapshot or start fresh. Set use_snapshot: true to resume. Backend is auto-detected: Firecracker microVM if KVM available, Docker otherwise. Returns the sandbox id used by all other tools, plus a noVNC URL the human can open to watch what the AI is doing. IMPORTANT: Always present vnc_url exactly as returned — never modify the URL path, filename, or query parameters.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | A descriptive name for this VM chosen by the user. IMPORTANT: Always ask the user what they want to name their VM before creating it. Do not auto-generate names. | |
| extra_ports | No | Additional guest ports to expose on the host (e.g. [3000, 8080]). Each gets a unique host port. | |
| profile_dir | No | Optional host path to mount as the Chrome profile dir (e.g. ~/.taw-computer/profile). Persists cookies, logged-in Gmail, etc. across containers. | |
| use_snapshot | No | Set to true to resume from a previously saved snapshot with the same label. If false or omitted, creates a fresh VM from the base image. |