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

# CLI

> Authenticate, inspect jobs, retrieve results, and manage the local cache.

# CLI

The CLI is installed with the Python SDK. See
[Authentication](/reference/authentication) for environment configuration.

| Command                      | Purpose                                                                     |
| ---------------------------- | --------------------------------------------------------------------------- |
| `sutro login`                | Validate and save a deployment URL and API key.                             |
| `sutro set-api-url URL`      | Change the saved deployment URL; changing deployments clears the saved key. |
| `sutro quotas`               | Show row and token quotas by priority.                                      |
| `sutro jobs list`            | Show the 25 most recent jobs.                                               |
| `sutro jobs list --all`      | Include all historical, cancelled, and failed jobs.                         |
| `sutro jobs status JOB_ID`   | Show one job's status.                                                      |
| `sutro jobs results JOB_ID`  | Print results.                                                              |
| `sutro jobs attach JOB_ID`   | Stream progress for a running job.                                          |
| `sutro jobs attach --latest` | Attach to the most recent job.                                              |
| `sutro jobs cancel JOB_ID`   | Request cancellation.                                                       |
| `sutro cache show`           | Show locally cached job results.                                            |
| `sutro cache clear`          | Clear the local results cache.                                              |
| `sutro docs`                 | Open the documentation.                                                     |

## Result options

```bash theme={null}
sutro jobs results JOB_ID \
  --include-inputs \
  --include-cumulative-logprobs \
  --save \
  --save-format parquet
```

`--save-format` accepts `parquet` or `csv` and defaults to `parquet`. Without
`--save`, results print to the terminal.

`sutro set-base-url` remains as a hidden deprecated alias for
`sutro set-api-url`.