Configure Red

Configure Red

Keep the embedded defaults and add only the settings you want to change.

Start with a small file

Red works without a configuration file. On macOS and Linux, create ~/.config/red/config.toml when you want to override a default. The welcome screen can create a starter file without replacing existing settings.

TOML
theme = "red.json"
scrolloff = 8

[search]
ignorecase = true
smartcase = true

[keys.normal]
"Ctrl-s" = "Save"

Your file is layered over Red's embedded configuration, so it doesn't need to repeat unchanged settings.

Check a change

Shell
red --check-config
red -c 'wrap = false' path/to/file

--check-config validates the effective user configuration and exits. The repeatable -c option applies a TOML override for one invocation.

Common sections

SectionControls
Top levelTheme, wrapping, scrolling, line numbers, release notes, diagnostics, and disabled plugins
[search]Incremental search, highlighting, wrapping, and case behavior
[completion]Automatic completion, buffer words, prefix length, and menu timing
[agent]Codex command, inline review behavior, followed tool calls, and explicitly enabled integrations
[updates]Whether Red installs updates in the background, only announces them, or doesn't check
[clipboard]Where yanks and copies go: the native clipboard, OSC 52 through the terminal, or nowhere
[keys.MODE]Mode-specific keybindings and chords
[languages.ID]Detection, comments, indentation, grammar, and language-server settings
[plugin_config.ID]Settings owned by an enabled plugin

Open the commented default configuration

Copy over SSH, Herdr, and tmux

From Red v0.10.0, yanks, Agent transcript copies, and plugin clipboard writes reach the clipboard of the computer you're typing on. Over SSH, inside Herdr, or in tmux, Red sends them through the terminal with OSC 52; on a local desktop it uses the native clipboard. Your terminal and every multiplexer in between must allow OSC 52 clipboard writes: attach Herdr with herdr --remote, and set set-clipboard on in tmux. Red keeps the text in its register even when delivery fails. To choose the route yourself:

TOML
[clipboard]
backend = "osc52" # "auto" (default), "native", "osc52", or "none"