> ## 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.
Every API command uses the configured deployment's `/v1` routes. After logging
in, use `sutro quotas` to verify that the deployment can reach Batch.

| 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 functions run NAME --input JSON` | [Run a Function](/functions/run) on one input and print the JSON response. `--input` takes a JSON object or `@path/to/input.json`. |
| `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`.


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