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 defines two 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 use a model host such as https://coda.api.rime.ai/, add it as an environment with rime config add.

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
--------------------------------------------------------------------------------
coda              https://coda.api.rime.ai/                          Bearer
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 coda

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 "coda"

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

# Add the Coda model host
rime config add coda --url https://coda.api.rime.ai/

Each model host, coda.api.rime.ai or mist.api.rime.ai, serves one model and routes each request to the nearest Rime region. The host picks the model, so pass the matching --model-id to rime tts.

​

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.