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

# Monitoring & Usage

> Measure latency, view character usage, and uninstall the Rime CLI.

## `rime speedtest`

Measure time-to-first-byte (TTFB) for configured environments. Sends a TTS request to each endpoint and reports latency.

```bash theme={null}
rime speedtest
```

### Flags

| Flag        | Short | Default | Description                                                                |
| ----------- | ----- | ------- | -------------------------------------------------------------------------- |
| `--model`   | `-m`  | `coda`  | Model ID for the test request                                              |
| `--runs`    | --    | `1`     | Number of requests per endpoint — reports mean/min/max when greater than 1 |
| `--timeout` | --    | `10s`   | Per-request timeout (`0` disables timeout)                                 |
| `--url`     | --    | --      | Additional URL to test, not in config (repeatable)                         |
| `--env`     | --    | --      | Only test these named environments from config (repeatable)                |
| `--yes`     | `-y`  | `false` | Automatically switch the default environment if a faster one is found      |

### Behavior

* No flags: tests all configured environments
* `--url` alone: tests only the specified URLs (config envs are skipped)
* `--env` + `--url`: tests both the named envs and the extra URLs
* When using `--url`, your configured API credentials are forwarded to those URLs (a warning is printed)
* After the test completes, if the fastest environment differs from the current default, the CLI prompts you to switch. Use `--yes` to skip the prompt and switch automatically.

### Example output (single run)

```
ENV             URL                                                TTFB
--------------------------------------------------------------------------------
users           https://users.rime.ai/v1/rime-tts                 245.12ms
users-east      https://users-east.rime.ai/v1/rime-tts            189.40ms

Fastest: users-east (189.40ms)
Switch default environment from "users" to "users-east"? [y/N]:
```

### Example output (`--runs 3`)

```
ENV             URL                                                TTFB (3 runs)
--------------------------------------------------------------------------------
users           https://users.rime.ai/v1/rime-tts                 mean=245.12ms  min=221.30ms  max=271.50ms
users-east      https://users-east.rime.ai/v1/rime-tts            mean=189.40ms  min=175.10ms  max=203.80ms

Fastest: users-east (189.40ms)
Switch default environment from "users" to "users-east"? [y/N]:
```

When `--runs` is greater than 1, the JSON output includes `ttfb_min_ms` and `ttfb_max_ms` fields in addition to `ttfb_ms` (mean).

***

## `rime usage`

Display daily character usage history for the past week, broken down by Mist, Arcana, and Coda models.

```bash theme={null}
rime usage
```

### Flags

| Flag    | Default | Description   |
| ------- | ------- | ------------- |
| `--csv` | `false` | Output as CSV |

Also supports the global `--json` flag.

### Example output

```
       Day  Mist Chars  Arcana Chars  Coda Chars       Total
----------  ----------  ------------  ----------  ----------
2026-05-19           0           500       3,400       3,900
2026-05-18         500         2,100           0       2,600
```

***

## `rime uninstall`

Remove the Rime CLI binary, configuration, and shell PATH entries. Detects whether the CLI was installed via Homebrew or the shell script and provides appropriate instructions.

```bash theme={null}
rime uninstall
```

### Flags

| Flag    | Short | Default | Description                  |
| ------- | ----- | ------- | ---------------------------- |
| `--yes` | `-y`  | `false` | Skip the confirmation prompt |

<Note>If installed via Homebrew, the command prints `brew uninstall rime` instead of performing removal directly.</Note>
