Reference Reference
Settings
Every configurable setting in Muxie, with its config key, type, default, and what it does.
Settings live behind Ctrl+, (Cmd+, on macOS). The config-key names below are how each setting appears in the stored config file.
Appearance
| Setting | Default | Description |
|---|---|---|
theme | dark | UI theme. Options: system, dark, black, mocha, muxie, muxie-light. |
accentColor | #6ea8fe | Accent color for buttons and highlights. |
customTitlebar | false | Draw a Muxie-colored titlebar with no OS chrome. Restart to apply. |
Terminal
| Setting | Default | Description |
|---|---|---|
fontFamily | "Noto Sans Mono", monospace | Terminal font. |
fontSize | 13 | Font size in px. Range 8–32. |
fontLigatures | false | Enable programming-font ligatures. |
showAllFonts | false | Show all fonts in the picker, not just monospace fonts. |
cursorStyle | block | Cursor shape. Options: block, bar, underline. |
cursorBlink | true | Blink the cursor. |
showScrollbar | false | Show the terminal scrollbar. |
scrollback | 1000 | Scrollback lines. Range 100–100000. |
terminalBell | visual | Bell behavior. Options: none, visual, sound. |
terminalEngine | ghostty-worker | Rendering engine. Options: xterm, ghostty-web, restty, ghostty-worker. Applies to new tabs. |
resetMouseTrackingOnPrompt | true | Clear stuck mouse mode at a shell prompt. |
Color scheme
| Setting | Default | Description |
|---|---|---|
terminalColorScheme | follow-theme | Terminal palette. Also accepts preset:<slug> or custom:<slug>. |
customColorSchemes | [] | User-created color schemes. |
Sidebar
| Setting | Default | Description |
|---|---|---|
sidebarShowGitBranch | true | Show the git branch in the sidebar. |
sidebarShowPorts | true | Show open ports in the sidebar. |
sidebarShowPullRequest | true | Show pull-request info in the sidebar. |
sidebarShowAgentStatus | true | Show agent status in the sidebar. |
sidebarShowDescription | true | Show the session description in the sidebar. |
collapsedGroupStyle | dividers | Style for collapsed groups. Options: dividers, folders. |
Notifications
| Setting | Default | Description |
|---|---|---|
notificationSound | default | Notification sound. Options: none, default, custom. |
notificationSoundPath | unset | Path to a custom notification sound. |
notificationCommand | unset | Shell command run on each notification (receives MUXIE_NOTIFY_* env). |
notificationMutePatterns | unset | Substring or /regex/flags patterns to suppress notifications. |
Behavior
| Setting | Default | Description |
|---|---|---|
restoreSession | true | Restore the layout on relaunch. |
confirmBeforeCloseTab | false | Confirm before closing a tab. |
confirmQuit | false | Confirm before quitting. |
newTabPlacement | end | Where new tabs open. Options: end, afterCurrent. |
copyOnSelect | true | Copy the selection to the clipboard. |
openFilesInSplit | true | Ctrl+click file paths open in a side pane. |
searchEngine | duckduckgo | Search engine. Options: duckduckgo, google, bing, bing-ai, perplexity. |
globalToggleHotkey | unset | Global show/hide accelerator. |
paneWorkloadNice | 5 | Scheduler niceness for pane shells. Range 0–19, 0 = off. |
Remote & agents
| Setting | Default | Description |
|---|---|---|
sshForwardOpens | true | Install a remote browser-open forwarder on SSH connections. |
spriteApiUrl | unset | sprites.dev REST API URL. |
spriteDefaultRegion | unset | Default sprite region. |
promptSpriteOnNewTab | true | Prompt for sprite vs local on a new tab. |
browserAutomationEnabled | false | Open a loopback CDP port so agents can drive browser panes. |
Advanced
| Setting | Default | Description |
|---|---|---|
orphanReapGraceMs | 3600000 (1h) | Auto-reap orphan durable sessions after this idle grace. 0 = off. |
keybindings | unset | Action-id → chord overrides. |
disabledPlugins | unset | Plugin ids you’ve disabled (everything else is enabled). |
dockCommands | unset | Pinned TUI command shortcuts. |
welcomeShownandlastSeenVersionare internal state, not user-facing settings.