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

> ## Agent Instructions
> Treat the Dreamscale Python SDK and CLI as the supported public integration surfaces.
> Prefer context-managed sessions and model-specific observation helpers.
> Do not infer or recommend internal control-plane APIs.

# CLI reference

> Use the supported Dreamscale command tree for authentication, diagnostics, sessions, simulation, and SO-101 setup.

The CLI supports account setup, diagnostics, live capacity checks, session
cleanup, a curated simulator, and the turnkey SO-101 path.

```text theme={null}
dreamscale
├── login
├── doctor [core|so101|sim|all]
├── sim
├── status
├── sessions
│   ├── list
│   └── stop
├── robots
│   └── so101
│       ├── setup
│       └── calibrate
└── run
    └── pick-place
```

Use `dreamscale <command> --help` as the exact installed-version reference.

## Account and health

```bash theme={null}
# Browser approval
dreamscale login

# Hidden API-key prompt for a headless machine
dreamscale login --api-key

# Robot-neutral checks
dreamscale doctor

# Embodiment-specific checks
dreamscale doctor so101
dreamscale doctor sim
dreamscale doctor all
```

Credentials are written to `~/.dreamscale/config.toml`, or read in place from
an [earlier install](/installation#choose-an-install). Never print or commit that file.

## Capacity

```bash theme={null}
dreamscale status
dreamscale status --model molmoact2-so101
dreamscale status --model molmoact2-droid --region us-west-2
```

`status` checks live model-region capacity without opening a cloud session.
Current model access and account-specific availability also appear in the
[dashboard](https://app.dreamscalelabs.com/dashboard/models).

## Sessions

```bash theme={null}
dreamscale sessions list
dreamscale sessions list --json
dreamscale sessions stop <session-id>
dreamscale sessions stop --all
```

Use `--all` only when you intend to terminate every open session on the
account. Closing sessions stops continued usage from abandoned leases.

## Local simulation

The `sim` command runs Dreamscale's curated local LIBERO path on your machine. It
is not a generic adapter for your own simulator, and Dreamscale does not host a
browser-based simulator:

```bash theme={null}
dreamscale sim \
  --task-suite libero_spatial \
  --task-id 0 \
  --max-steps 600 \
  --transport auto \
  --region nearest
```

Useful options:

* `--task-suite` and `--task-id` select a LIBERO task.
* `--task-seed` sets the initial-state seed.
* `--max-steps` or `--max-duration` sets one episode budget.
* `--non-interactive` disables the viewer and prints a JSON summary.
* `--transport auto|quic|relay` selects the network path.
* `--region nearest|available|<AWS region>` selects placement.
* `--verbose` exposes raw session and endpoint diagnostics.
* `--output-root <path>` writes a run artifact bundle.

The `sim` extra is Linux/WSL2 only. Run `dreamscale doctor sim` first.

## SO-101

```bash theme={null}
dreamscale robots so101 setup
dreamscale robots so101 calibrate
dreamscale doctor so101
dreamscale run pick-place --duration 60
dreamscale run pick-place --no-fallback
```

* `setup` detects and saves the arm, side camera, and wrist camera.
* `calibrate` writes `~/.dreamscale/calibration/so101.json`.
* `doctor so101` gates the hardware path.
* `run pick-place` starts dry on a newly configured machine and asks for
  explicit confirmation before persisting motion.
* `--no-fallback` refuses the hosted relay if QUIC/UDP is unavailable.

Read the complete [SO-101 safety sequence](/guides/so101) before running the
motion command.

## Shell completion

```bash theme={null}
dreamscale --install-completion
```

If a documented command is missing, compare `dreamscale --help` with
`0.1.0a26` and follow the [upgrade instructions](/installation#upgrade).