cmuxcmux/docs

Configuration

cmux reads configuration from Ghostty config files, giving you familiar options if you're coming from Ghostty.

Config file locations

cmux looks for configuration in these locations (in order):

  1. ~/.config/ghostty/config
  2. ~/Library/Application Support/com.mitchellh.ghostty/config

Create the config file if it doesn't exist:

mkdir -p ~/.config/ghostty
touch ~/.config/ghostty/config

Appearance

Font

~/.config/ghostty/config
font-family = JetBrains Mono
font-size = 14

Colors

~/.config/ghostty/config
# Theme (or use individual colors below)
theme = Dracula

# Custom colors
background = #1e1e2e
foreground = #cdd6f4
cursor-color = #f5e0dc
cursor-text = #1e1e2e
selection-background = #585b70
selection-foreground = #cdd6f4

Split panes

~/.config/ghostty/config
# Opacity for unfocused splits (0.0 to 1.0)
unfocused-split-opacity = 0.7

# Fill color for unfocused splits
unfocused-split-fill = #1e1e2e

# Divider color between splits
split-divider-color = #45475a

Behavior

Scrollback

~/.config/ghostty/config
# Number of lines to keep in scrollback buffer
scrollback-limit = 10000

Working directory

~/.config/ghostty/config
# Default directory for new terminals
working-directory = ~/Projects

App settings

In-app settings are available via cmux → Settings (⌘,):

Theme mode

  • System — follow macOS appearance
  • Light — always light mode
  • Dark — always dark mode

Automation mode

Control socket access level:

  • Off — no socket control (most secure)
  • Notifications only — only allow notification commands
  • Full control — allow all socket commands
On shared machines, consider using “Notifications only” mode to prevent other processes from controlling your terminals.

Example config

~/.config/ghostty/config
# Font
font-family = SF Mono
font-size = 13

# Colors
theme = One Dark

# Scrollback
scrollback-limit = 50000

# Splits
unfocused-split-opacity = 0.85
split-divider-color = #3e4451

# Working directory
working-directory = ~/code