rime config

Manage Rime CLI configuration and named environments with rime config subcommands.

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

Flag	Default	Description
--force	false	Overwrite an existing config file

The generated file looks like:

default_env = "users"

[env.users]
api_url = "https://users.rime.ai/v1/rime-tts"
api_key = "your_api_key_here"

[env.users-east]
api_url = "https://users-east.rime.ai/v1/rime-tts"
api_key = "your_api_key_here"

rime config init pre-configures both standard Rime endpoints as named environments. The default_env field names the active one.

Older config files without default_env continue to work: the top-level api_url and api_key fields are still respected as the fallback default.

rime config list

List all configured environments. The currently active default environment is marked with a * in the NAME column.

rime config list

NAME            URL                                                AUTH
--------------------------------------------------------------------------------
users *         https://users.rime.ai/v1/rime-tts                 Bearer
users-east      https://users-east.rime.ai/v1/rime-tts            Bearer

Flag	Default	Description
--json	false	Output as JSON

rime config default

Get or set the default environment.

# Print the current default environment name
rime config default

# Switch the default to a different environment
rime config default users-east

With no arguments, prints the name of the current default environment:

users

With a name argument, updates default_env in ~/.rime/rime.toml and confirms:

Default environment set to "users-east"

No flags.

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

Flag	Short	Default	Description
--env	-e	default	Environment to show
--json	—	false	Output as JSON
--show-key	—	false	Display the full API key (redacted by default)

Example output:

Environment:  users
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 default to change which environment is the default.

rime config add <name>

Flag	Description
--url	API URL (default: https://users.rime.ai/v1/rime-tts)
--key	API key (skips interactive prompt)
--auth-prefix	Auth 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>

Flag	Short	Default	Description
--yes	-y	false	Skip 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.