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

# CLI

> Rial from your terminal.

```bash theme={"dark"}
npm i -g @rial/cli
```

## Thirty seconds

```bash theme={"dark"}
rial login                                   # opens the dashboard, stores a token

rial create --step "front: Please take a photo of the front of your 2021 Toyota Corolla" \
            --match-location "Av. Córdoba 5635, Buenos Aires" \
            --match-object "2021 Toyota Corolla"
# → prints a capture link. Send it.

rial watch vfy_01H...                        # exits 0 when it completes
rial get   vfy_01H...                        # the verdict
```

`rial create` with no flags mints a one-photo link that expires in an hour.

## Commands

| Command | Does |
| - | - |
| `rial login` | Log in through the browser. `--api-key rk_secret_…` for servers. |
| `rial whoami` / `rial logout` | Check or drop the session. |
| `rial create [...]` | Mint a verification. `--steps-file steps.json` for multi-step forms. |
| `rial get <id>` | Status and verdict. |
| `rial watch <id>` | Poll until it settles. Exit code: `0` completed, `1` failed, `2` expired. |
| `rial list [--status completed]` | Recent verifications. |
| `rial templates validate <file>` | Check a template JSON offline. |
| `rial templates apply <file> [--dry-run]` | Create or update a template. Only declared fields change. |
| `rial templates list` / `get <slug>` | Your templates. |
| `rial templates simulate <slug>` | Test a template without using quota. |
| `rial templates mint <slug> [--identification v] [--webhook url] [--meta k=v] [--expires 2h]` | One single-use link off a template. Flags override the template. |

## Scripts and CI

Set `RIAL_API_KEY` and skip `login`. Add `--json` to any command for the raw API response.

Several accounts? `rial login --profile acme` keeps one session per profile; pass `--profile acme` to any command.


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