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

# Environments

> The CLI has two modes — sandbox and live. Use veil mode to switch, or --live for a one-shot override.

The CLI uses the same two-mode model as the rest of Veil: **sandbox** and **live**. All reads and writes are scoped to the active mode. See [Sandbox vs. production](/concepts/sandbox-vs-production) for context.

## Active mode

After pairing, your active mode defaults to `sandbox`. Check or switch it with `veil mode`:

```bash theme={null}
# Show the current mode
veil mode

# Switch to live
veil mode live

# Switch back to sandbox
veil mode sandbox
```

Switching modes requires that the corresponding credentials exist. If you try `veil mode live` before completing production KYC, the CLI prints an error. A switch is also refused if the target mode's key has been revoked or expired server-side — the CLI will tell you to run `veil login` to restore it.

## One-shot override

Every command accepts `--live` to use live mode for that invocation only, without changing the persisted active mode:

```bash theme={null}
veil wallets list --live
veil transactions list --live --status pending
```