Configuration

Rabbitty reads a plain key = value file at ~/.config/rabbitty/config (override the path with the RABBITTY_CONFIG environment variable). Lines starting with # are comments and blank lines are ignored; unknown keys are skipped, and any value that fails to parse falls back to its default. Rabbitty never refuses to start over a bad config.

# ~/.config/rabbitty/config
theme = One Light
font_family = JetBrainsMono Nerd Font
ui_font_family = Inter
font_size = 14

Settings

theme

string · default One Light

UI + terminal color theme. Any bundled theme, or the name of a Ghostty theme file. All chrome derives from the terminal palette.

Allowed: One Light, GitHub Light, Dark, Catppuccin Latte, Catppuccin Mocha

font_family

string · default Menlo

Terminal grid font. Any installed font; Nerd Font glyphs always fall back so shell/ls/powerline icons render.

ui_font_family

string · default .SystemUIFont

Interface font for the chrome (sidebar, command palette, quick switcher, tabs). The terminal grid uses font_family instead.

font_size

number · default 14

Terminal grid font size, in points. Adjustable at runtime with ⌘+ / ⌘− (which persists here).

option_as_meta

boolean · default false

Treat the macOS Option key as Meta (Esc-prefix) instead of composing accented characters — useful for Emacs-style bindings.

Allowed: true, false

sound

boolean · default true

Play an in-app chime when an agent finishes or needs you while Rabbitty is the active app.

Allowed: true, false

status_source

string · default hook-then-scrape

How an agent's status is read: from its reported hooks, from on-screen scraping, or a combination.

Allowed: hook-then-scrape, scrape, hooks, scrape-then-hook