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

# CLI

> Commands for models, deployments and access.

Authenticate with `servo login`. Use `servo COMMAND --help` for all flags.
See the [quickstart](/quickstart) for a complete example.

## Models and deployments

| Command | Purpose |
| - | - |
| `servo model inspect hf://ORG/REPO --revision REV` | Show input keys, shapes, dtypes and output shape without allocating a GPU |
| `servo model import hf://ORG/REPO --revision REV` | Prepare a checkpoint using your connected Hugging Face account |
| `servo model list` | List models |
| `servo model deploy MODEL_ID --city CITY --wait` | Deploy and wait for readiness |
| `servo deployment list` | List deployments; `--links` includes dashboards |
| `servo deployment show ID` | Inspect status and failures |
| `servo deployment wait ID` | Wait for readiness |
| `servo deployment logs ID` | Open links to logs and telemetry |
| `servo deployment stop ID` | Request shutdown; use `show` to confirm retirement |

Deploy accepts one of `--city`, `--region`, `--latlon` or `--robot`.
Use `--deployment-key` for a separate deployment at the same site.
`--idle-minutes` opts into idle release; otherwise capacity stays warm until stopped.
Predict through the [Python SDK](/reference/python-api).

## Identity and robots

| Command | Purpose |
| - | - |
| `servo login` | Browser or device-code sign-in |
| `servo whoami` | Show current identity and organization |
| `servo logout` | Sign out; `--everywhere` ends all sign-ins |
| `servo agent install --name NAME` | Enroll this robot computer and run its agent |
| `servo robot approve [CODE]` | Approve enrollment; without a code, opens the page to enter it |
| `servo robot list` | List robots |
| `servo robot show NAME` | Inspect robot and sessions |
| `servo robot remove NAME` | Revoke installations and retire the robot |
| `servo doctor` | Diagnose session connectivity |

## Access and recordings

| Command | Purpose |
| - | - |
| `servo access grant SUBJECT --robot NAME --role ROLE` | Grant `read`, `write` or `admin` |
| `servo access list --robot NAME` | List grants |
| `servo access revoke SUBJECT --robot NAME` | Remove a grant |
| `servo session list` | List recorded sessions; filter with `--robot NAME` |
| `servo session show ID` | Inspect a recorded session |
| `servo episode list` | List local recordings |
| `servo episode show PATH` | Summarize a recording; `--last` picks the newest |
| `servo episode rm PATH` | Delete a recording after confirmation |

See [identity and access](/guides/identity) for required roles.


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