Skip to main content
Manage CLI configuration. The config file is TOML-based and lives at ~/.rime/rime.toml.

rime config init

Create a new config file. Prompts for an API key interactively.
rime config init
FlagDefaultDescription
--forcefalseOverwrite an existing config file
The generated file looks like:
api_key = "your_api_key"
api_url = "https://users.rime.ai/v1/rime-tts"

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

rime config list

List all configured environments.
rime config list
FlagDefaultDescription
--jsonfalseOutput as JSON

rime config show

Show the fully resolved configuration for a given environment, including where the API key comes from (config file vs. environment variable).
rime config show
FlagShortDefaultDescription
--env-edefaultEnvironment to show
--jsonfalseOutput as JSON
--show-keyfalseDisplay the full API key (redacted by default)
Example output:
Environment:  default
API URL:      https://users.rime.ai/v1/rime-tts
API Key:      rime_aHR0cHM6Ly... (redacted)
Auth Prefix:  Bearer
Auth Header:  Authorization: Bearer (redacted)

rime config add

Add a named environment to ~/.rime/rime.toml. Prompts interactively for API URL, API key (input hidden), and an optional auth prefix. You cannot add an environment named default — use rime config init to modify the default.
rime config add <name>
FlagDescription
--urlAPI URL (default: https://users.rime.ai/v1/rime-tts)
--keyAPI key (skips interactive prompt)
--auth-prefixAuth header prefix, e.g. Bearer (optional)
Examples:
# Add a staging environment interactively
rime config add staging

# Add an on-prem environment non-interactively
rime config add onprem --url https://rime.internal:8080/v1/rime-tts --key your_key_here

rime config rm

Remove a named environment from ~/.rime/rime.toml. Prompts for confirmation unless --yes is passed.
rime config rm <name>
FlagShortDefaultDescription
--yes-yfalseSkip confirmation prompt

rime config edit

Open ~/.rime/rime.toml in your default editor ($VISUAL or $EDITOR, falling back to nano or vi).
rime config edit
No flags. Requires the config file to exist — run rime config init first if needed.