Configuration

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

Config File Locations

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

~/.config/ghostty/config
~/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 Options

Font

font-family = JetBrains Mono
font-size = 14

Colors

# 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

# 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 Options

Scrollback

# Number of lines to keep in scrollback buffer
scrollback-limit = 10000

Working Directory

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

App Settings

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

Theme Mode

Choose between:

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

Here's a complete example configuration:

# 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

Configuration

On this page