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 appearance and behavior",
};
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):
-
~/.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
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
-
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
{`# 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`}
>
);
}