Home › Tutorials › Getting Started
Getting Started

Configuring Rysh

#004 0:24 Part of the Rysh video series

One TOML file controls everything -- and every setting has an env-var override.

Configuring Rysh — 0:24 walkthrough

What you'll see

  1. Open the config at ~/.config/rysh/rysh.config (TOML).
  2. [provider] -- set model and api_key for the Anthropic API (or fall back to the claude CLI).
  3. [ui] -- set shell, initial_tabs, and initial_panes.
  4. [upstream] -- enable remote sharing with url and api_key.
  5. Override any value via env, e.g. RYSH_API_KEY=sk-ant-... rysh.

Commands shown

cat ~/.config/rysh/rysh.config
echo '[provider]'
echo 'model = claude-sonnet-4-20250514'
echo 'api_key = sk-ant-...'
echo '[ui]'
echo 'shell = /bin/bash'
echo 'initial_tabs = 2'
echo 'initial_panes = 1'
echo '[upstream]'
echo 'enabled = true'
echo 'url = https://rysh.works/workspaces/team'
echo 'api_key = ...'
RYSH_API_KEY=sk-ant-xxxx rysh

Keys used

Enter

Transcript

0:00Rysh reads one TOML config file -- and every setting also has an environment-variable override.

0:05The config lives at ~/.config/rysh/rysh.config, or rysh.config in your current directory.

0:13The provider section sets your model and API key. Set api_key to call the Anthropic API directly -- otherwise Rysh falls back to the claude CLI.

0:24The ui section controls your shell and how many tabs and panes open on a fresh start.

0:34The upstream section enables remote sharing -- point it at a rysh-server and drop in an API key.

0:42Every value has an env override. Just prefix your launch -- here, RYSH_API_KEY -- and rysh picks it up.

Key takeaway
Everything is configurable via the TOML file or environment variables -- API keys, shell, layout, and upstream server.