import type { Metadata } from "next"; import { CodeBlock } from "../../components/code-block"; import { Callout } from "../../components/callout"; export const metadata: Metadata = { title: "Configuration", description: "Configure cmux via Ghostty config files. Font, theme, colors, split pane styling, scrollback, and app settings for automation mode.", }; export default function ConfigurationPage() { return ( <>

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

{`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

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 cmux → Settings ( ⌘,):

Theme mode

Automation mode

Control socket access level:

On shared machines, consider using “Off” or “cmux processes only” mode.

Browser link behavior

In Settings → Browser, cmux exposes two host lists with different purposes:

Example 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`} ); }