cmuxcmux/docs

Konfiguration

cmux liest die Konfiguration aus Ghostty-Konfigurationsdateien, was Ihnen vertraute Optionen bietet, wenn Sie von Ghostty kommen.

Speicherorte der Konfigurationsdatei

cmux sucht an diesen Speicherorten nach Konfiguration (in dieser Reihenfolge):

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

Erstellen Sie die Konfigurationsdatei, falls sie nicht existiert:

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

Erscheinungsbild

Schriftart

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

Farben

~/.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

Geteilte Bereiche

~/.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

Verhalten

Scrollback

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

Arbeitsverzeichnis

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

App-Einstellungen

In-App-Einstellungen sind über cmux > Einstellungen (⌘,) verfügbar:

Design-Modus

  • System: macOS-Erscheinungsbild folgen
  • Hell: Immer heller Modus
  • Dunkel: Immer dunkler Modus

Automatisierungsmodus

Zugriffsebene der Steuerungs-Socket:

  • Aus: Kein Socket-Zugriff (am sichersten)
  • Nur cmux-Prozesse: Nur Prozesse, die in cmux-Terminals gestartet wurden, können sich verbinden
  • allowAll: Jeden lokalen Prozess verbinden lassen (CMUX_SOCKET_MODE=allowAll, nur per Umgebungsvariable)
Auf gemeinsam genutzten Rechnern sollten Sie den Modus "Aus" oder "Nur cmux-Prozesse" verwenden.

Browser-Link-Verhalten

Unter Einstellungen > Browser stellt cmux zwei Host-Listen mit unterschiedlichen Zwecken bereit:

  • Hosts im eingebetteten Browser öffnen: Gilt für Links, die aus der Terminal-Ausgabe geklickt werden. Hosts in dieser Liste öffnen sich in cmux; andere Hosts öffnen sich in Ihrem Standardbrowser. Unterstützt einen Host oder Wildcard pro Zeile (zum Beispiel: example.com, *.internal.example).
  • Im eingebetteten Browser erlaubte HTTP-Hosts: Gilt nur für HTTP-URLs (nicht HTTPS). Hosts in dieser Liste können in cmux ohne Warnhinweis geöffnet werden. Standardmäßig enthalten sind localhost, 127.0.0.1, ::1, 0.0.0.0 und *.localtest.me.

Beispielkonfiguration

~/.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