Settings

Open Settings with ⌘,, or via Verne › Settings… in the menu bar. Changes take effect immediately, with no save step.

Appearance

Option What it does
Theme The active color theme, with a live preview below the selector.

See Themes for the available options and how to add custom themes.

Workspace

Option What it does
Auto-save Save files automatically after changes
Default IDE The IDE launched by the Open button on a file or workspace
Worktrees root folder Where new worktrees are created (defaults to ~/.verne/worktrees/)
Reset panel sizes Restore sidebars and panels to their default widths (reloads the window)

Editor

Option What it does
Font Family, size (px), weight, line height, and ligatures.
Behavior Tab size, insert spaces, word wrap, line numbers, sticky scroll (pins scope headers while scrolling), and multi-cursor modifier (Alt or Ctrl/Cmd).
Minimap Show or hide, render mode (characters or blocks), scale, slider visibility, and autohide.
Markdown Default view when opening .md files (Preview or Edit).
Language server Toggle LSP hover, completions, and diagnostics on or off.

Terminal

Option What it does
Font family Terminal font
Font size Size in pixels
Font weight / Bold font weight Regular and bold weights separately
Line height Multiplier (e.g. 1.2)
Padding Inner padding around the terminal grid in px
Font ligatures Enable ligature rendering
Cursor style Block, beam, or underline (programs can still override this)
Cursor blink Toggle cursor blinking
Renderer WebGL (GPU-accelerated) or Canvas (compatibility fallback)

Files

Option What it does
Files exclude Glob patterns for files to hide from the file explorer and search results. Add a pattern, toggle patterns on or off, or remove them individually.

Directories

Option What it does
Default base ref for new worktrees Set per directory. The branch new worktrees are created from (e.g. origin/main). Leave blank to use the directory’s HEAD.

Languages

Option What it does
Per-language overrides For a selected language (TypeScript, JavaScript, JSON, Rust, Python, Go, HTML, CSS, Vue, Markdown), override tab size, insert spaces, or word wrap. These take precedence over the global Editor settings for that language.

Voice

Option What it does
Enable voice Turn dictation on or off.
Mode Toggle (press to start and stop) or Hold (hold to speak).
Hotkey Click the key display to capture a new binding.
Speech models Download or remove dictation models.

See Voice setup for details.

Agents

Option What it does
Agent MCP access Install or remove the Verne MCP server per agent. Expand a row to view or copy the manual install commands.
Review Agent The agent that receives a diff when you request changes.

See Hooks & MCP setup for a walkthrough.

Notifications

Option What it does
Mute while focused Suppress OS notifications when Verne is the active window
In-app agent alerts Show a toast when an agent needs attention while Verne is focused
Play notification sound Play a sound alongside notifications
Send Test Fire an OS notification and an in-app toast to verify both work

Next steps