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

# celesto sandbox list

> Use celesto sandbox list to view sandboxes, filter by state, and produce JSON for scripts.

`celesto 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}
celesto sandbox list [OPTIONS]
```

## Examples

### List running sandboxes

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

### List every sandbox

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

### Filter by state

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

### Use JSON output

```bash theme={null}
celesto sandbox list --json
```

```json theme={null}
{
  "ok": true,
  "command": "sandbox.list",
  "exit_code": 0,
  "data": {
    "filters": {
      "all": false,
      "status": "running"
    },
    "vms": [
      {
        "name": "my-sandbox",
        "preset": null,
        "status": "running",
        "pid": 12345,
        "ip_address": "172.16.0.2",
        "ssh_port": 2222,
        "warnings": []
      }
    ]
  },
  "error": null
}
```

## Options

**--all** `flag`

Show every sandbox, including stopped, created, paused, and errored sandboxes.

**--status** `string`

Show only sandboxes in one state. Use one of the states printed by `celesto sandbox list --all`.

**--json** `flag`

Print a JSON envelope instead of a table.

> [!NOTE]
>
> Use either `--all` or `--status`, not both.

## Related commands

* [`celesto sandbox create`](https://celesto.ai/docs/celesto/cli/create) - Create a sandbox
* [`celesto sandbox info`](https://celesto.ai/docs/celesto/cli/overview) - Show details for one sandbox
* [`celesto sandbox delete`](https://celesto.ai/docs/celesto/cli/cleanup) - Delete one or more sandboxes


## Related topics

- [celesto sandbox snapshot](https://celesto.ai/docs/celesto/cli/snapshot.md)
- [celesto sandbox ssh](https://celesto.ai/docs/celesto/cli/ssh.md)
- [celesto sandbox create](https://celesto.ai/docs/celesto/cli/create.md)
- [celesto sandbox delete](https://celesto.ai/docs/celesto/cli/cleanup.md)
- [celesto sandbox prune](https://celesto.ai/docs/celesto/cli/sandbox-prune.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.