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

telemetry

boolean · default true

Send anonymous telemetry events (app launch, agent startups, state transitions) to improve Rabbitty. Respects user privacy; no sensitive code or PII is sent.

Allowed: true, false

preferred_ide

string · default Zed

Which editor the top-bar Open button and ⌘O open the current terminal's folder in. Auto-detected from your installed apps (Zed preferred); falls back to Finder if none is found. Set it to any detected editor's name to override.

usage_enabled

boolean · default false

Enable the Usage panel — per-agent limits (session/weekly/monthly) via the bundled CodexBar helper. Off by default: the first fetch prompts for macOS Keychain access to read your agents' credentials. Toggle it from the panel or the command palette.

Allowed: true, false