Skip to main content
smolvm sandbox list shows the sandboxes on your machine. Use it to find a sandbox name, check whether one is still running, or feed sandbox data into a script.

​
Synopsis

smolvm sandbox list [OPTIONS]

​
Options

​
--all
flag
Show every sandbox, including stopped, created, paused, and errored sandboxes.
​
--status
string
Show only sandboxes in one lifecycle state. Use one of the states printed by smolvm sandbox list --all.
​
--json
flag
Print a JSON envelope instead of a table.
Use either --all or --status, not both.

​
Examples

​
List running sandboxes

smolvm sandbox list

​
List every sandbox

smolvm sandbox list --all

​
Filter by state

smolvm sandbox list --status stopped

​
Use JSON output

smolvm sandbox list --all --json

{
  "ok": true,
  "command": "sandbox.list",
  "exit_code": 0,
  "data": {
    "filters": {
      "all": true,
      "status": null
    },
    "vms": [
      {
        "name": "my-sandbox",
        "status": "running",
        "pid": 12345,
        "ip_address": "172.16.0.2",
        "ssh_port": 2222,
        "warnings": []
      }
    ]
  },
  "error": null
}
Last modified on June 24, 2026