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

# CLI reference

> All vpod CLI commands and options.

## Commands

| Command                | Description                                          |
| :--------------------- | :--------------------------------------------------- |
| `vpod`                 | Start an interactive shell with the default snapshot |
| `vpod <snapshot>`      | Start an interactive shell with a specific snapshot  |
| `vpod pull <snapshot>` | Pull a snapshot                                      |
| `vpod list`            | List available snapshots                             |

## Options

### `--mount`, `-m`

Create a link between your host and your sandbox by mounting a directory. You can configure read-only or read-write permissions for better access control.

```bash theme={null}
vpod --mount workspace:/workspace     # read only
vpod --mount workspace:/workspace:rw  # read and write
```

<Tip>
  Mounts are read-only by default. Append `:rw` to the sandbox path to allow writes back to the host.
</Tip>