Reference - Rime Docs

Global flags (all commands)

Flag	Short	Default	Description
`--quiet`	`-q`	`false`	Suppress non-essential output
`--json`	—	`false`	Output results as JSON
`--env`	`-e`	—	Named environment to use from config
`--config`	`-c`	—	Path to a custom config file
`--version`	`-v`	—	Print version information
`--help`	`-h`	—	Help for any command

Environment variables

Variable	Description
`RIME_CLI_API_KEY`	API key for authentication (overrides the key in `rime.toml`)
`RIME_API_URL`	API endpoint URL (overrides the URL in `rime.toml`)
`RIME_AUTH_HEADER_PREFIX`	Authorization header prefix (default: `Bearer`)
`RIME_DASHBOARD_URL`	Dashboard URL for `rime login` (default: `https://app.rime.ai`)

Configuration

The CLI uses a TOML config file at ~/.rime/rime.toml. You can define multiple named environments for different API endpoints.

api_key = "your_api_key"
api_url = "https://users.rime.ai/v1/rime-tts"

[env.staging]
api_url = "https://staging.rime.ai/v1/rime-tts"

[env.onprem]
api_url = "https://rime.internal:8080/v1/rime-tts"
api_key = "different_key"
auth_header_prefix = "Api-Key"

Select an environment with the --env flag:

rime tts "Hello" -s astra -m coda --env staging

Resolution order: Environment variables override config file values, which override defaults. Within the config file, named environment values override top-level values.

Audio formats

Format	Extension	Default for	Notes
WAV	`.wav`	`coda`, `arcana`, `arcanav2`, `mistv3`	Uncompressed, higher quality, larger files
MP3	`.mp3`	`mistv2`, `mist`	Compressed, smaller files

The CLI retains arcana and arcanav2 for deprecated integrations. Use coda or a Mist model for new requests.

Metadata embedding

Audio files saved by the CLI include embedded metadata (voice, model, text). This metadata is visible in rime play waveform output and in media players like Finder or Preview.

WAV files: LIST/INFO chunk (IART, INAM, ICMT)
MP3 files: ID3v2.3 tags (TPE1, TIT2, COMM)

⌘I