> ## Documentation Index
> Fetch the complete documentation index at: https://docs.celesto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# smolvm sandbox list

> Use smolvm sandbox list to view running, stopped, paused, and errored sandboxes, filter by lifecycle state, and produce JSON for scripts.

`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

```bash theme={null}
smolvm sandbox list [OPTIONS]
```

## Options

<ParamField path="--all" type="flag">
  Show every sandbox, including stopped, created, paused, and errored sandboxes.
</ParamField>

<ParamField path="--status" type="string">
  Show only sandboxes in one lifecycle state. Use one of the states printed by `smolvm sandbox list --all`.
</ParamField>

<ParamField path="--json" type="flag">
  Print a JSON envelope instead of a table.
</ParamField>

<Note>
  Use either `--all` or `--status`, not both.
</Note>

## Examples

### List running sandboxes

```bash theme={null}
smolvm sandbox list
```

### List every sandbox

```bash theme={null}
smolvm sandbox list --all
```

### Filter by state

```bash theme={null}
smolvm sandbox list --status stopped
```

### Use JSON output

```bash theme={null}
smolvm sandbox list --all --json
```

```json theme={null}
{
  "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
}
```

## Related commands

* [`smolvm sandbox create`](/smolvm/cli/create) - Create a sandbox
* [`smolvm sandbox info`](/smolvm/cli/overview) - Show details for one sandbox
* [`smolvm sandbox delete`](/smolvm/cli/cleanup) - Delete one or more sandboxes