Settings & themes

Settings is one dialog, opened from the gear on the rail's account chip or with s in command mode. Everything applies instantly — there is no Save button — and a Search settings box at the top of the section list jumps straight to the right section when you can't remember which one owns cursor blink.

General

The guard rails and the small defaults:

• Confirm before quitting while agents are mid-work (on by default). The quit gesture defers to a dialog that names how many are working.
• Confirm before closing a pane — by default only when its agent is busy or waiting, and it asks inside the pane rather than as a global dialog.
• New panes start with — ask, a terminal, or a specific agent profile, so splits and empty panes fill themselves without a click.
• Agent sounds — one switch for the chimes, with a sub-switch each for "needs input" and "finished" so you can keep only the urgent one, plus only while the app is in the background for chimes that speak up only when your attention is elsewhere. The sub-switches stay visible while the main switch is off, and remember what you picked.
• Logs: days kept.

Themes

One theme paints the whole app: the chrome, every terminal (background plus the 16 ANSI colors your agents' TUIs draw with), and the code editor's chrome and syntax highlighting all read from the same palette, so nothing looks bolted on.

Twenty themes ship — the stock VibeGuild Dark and Light, plus Dracula, Nord, One Dark and Light, Solarized Dark and Light, Gruvbox Dark and Light, Monokai, Tokyo Night, Catppuccin Mocha and Latte, GitHub Dark and Light, Ayu Mirage, Rosé Pine and Dawn, and Night Owl, each true to its official palette. The tab shows every one as a miniature window painted in its own colors, grouped into dark, light, and yours.

The fast path is the palette: t in command mode (or type "theme") lists them all, and arrowing through live-previews across the whole app. Enter keeps it, Esc puts everything back.

Custom themes

Custom themes are plain JSON files in an app folder — "New theme from current" seeds one from what you're using, fully spelled out, and "Open themes folder" reveals it. Set as few as three colors (background, foreground, accent) and the rest is derived for you with contrast guards; every field can then be tuned by hand, terminal ANSI and syntax colors included. Edits hot-reload while the app runs, and a file with a mistake in it is reported by name on this tab instead of breaking anything else.

Terminal

The xterm surface, live across every open terminal: font size, family and weight (plus a separate bold weight), line height, font ligatures, cursor style and blink, and scrollback lines. Then the behavior:

• Links open in — the built-in browser or your system browser. Cmd/Ctrl-click opens a link in the one you chose; adding Shift opens the other.
• Programs can write the clipboard — OSC 52 support, write-only by design. Programs may copy to your clipboard; reads are always answered empty, because any program in the terminal could otherwise exfiltrate what you had copied.
• Option as Meta on macOS.
• Terminal shell on Windows: which shell plain terminal panes open in. Auto prefers PowerShell 7; Windows PowerShell, Command Prompt and WSL are one click away. Agents and worktree setup commands stay on the system shell either way.

Editor

Font size and family, line numbers, minimap, sticky scroll, bracket pair colorization, whitespace rendering, and tab size — applied to the editor panel. Colors come from the theme, not from here.

Browser

Whether the address bar remembers visited addresses for autocomplete, and a button to clear that history.

Keyboard

Rebinds everything: the reserved shortcuts (key-only, and a conflict is refused), every command's leader sequence (press the new keys, Enter saves, and a collision names the command it collides with), and the editor and browser tool shortcuts. Agent and workspace commands keep their numbered slots. While a key recorder is armed, Esc is two-step: the first press cancels the capture, the next closes the dialog.

See Keyboard & commands for what all of it does.

Voice

Enable voice input, the push-to-talk key, the transcription model, the spoken language, and the microphone. Details and the privacy story are on the keyboard page.

Agent profiles

Add, edit, reorder, and hide the CLI agents the app can launch — the whole tab is documented in Agents & profiles.

Worktrees

The setup command run in a freshly created worktree before its agent starts, e.g. pnpm install. A multi-repo workspace gets one field per repo. The worktrees on disk are listed and managed — pin, reveal, delete — in the git panel.

Account

Sign in and out, see your plan, and open account management on this site. See Accounts & beta.

Where settings live

Everything writes through to a settings.json in the app's data folder. If loading or saving ever fails, the dialog banners it — defaults in effect, or edits not landing — rather than quietly forgetting what you chose.