rime config

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

The rime config subcommands manage ~/.rime/rime.toml, the TOML file that holds your API key and named environments.

rime config init

Create a new config file. In a terminal, the command prompts for an API key. You can press Enter to skip it and add the key later.

rime config init

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

The generated file names both standard Rime endpoints as environments and makes users the default:

api_key = "your_api_key_here"
default_env = "users"

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

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

Both environments inherit the single top-level api_key. To find out which endpoint responds faster from your network, run rime speedtest. It also offers to switch default_env to the faster 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.