Configuration

cmux lit la configuration depuis les fichiers de configuration Ghostty, vous offrant des options familières si vous venez de Ghostty.

Emplacements des fichiers de configuration

cmux cherche la configuration dans ces emplacements (dans l'ordre) :

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

Créez le fichier de configuration s'il n'existe pas :

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

Apparence

Police

font-family = JetBrains Mono
font-size = 14

Couleurs

# 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

Panneaux divisés

# 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

Comportement

Historique

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

Répertoire de travail

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

Paramètres de l'application

Les paramètres de l'application sont accessibles via cmux > Réglages (⌘,) :

Mode de thème

• Système : suivre l'apparence macOS
• Clair : toujours en mode clair
• Sombre : toujours en mode sombre

Mode automatisation

Niveau d'accès au socket de contrôle :

• Désactivé : pas d'accès au socket (le plus sécurisé)
• Processus cmux uniquement : seuls les processus démarrés dans les terminaux cmux peuvent se connecter
• allowAll : autoriser tout processus local à se connecter (CMUX_SOCKET_MODE=allowAll, remplacement par variable d'environnement uniquement)

Comportement des liens du navigateur

Dans Réglages > Navigateur, cmux expose deux listes d'hôtes avec des objectifs différents :

• Hôtes à ouvrir dans le navigateur intégré : s'applique aux liens cliqués depuis la sortie du terminal. Les hôtes de cette liste s'ouvrent dans cmux ; les autres hôtes s'ouvrent dans votre navigateur par défaut. Supporte un hôte ou un joker par ligne (par exemple : example.com, *.internal.example).
• Hôtes HTTP autorisés dans le navigateur intégré : s'applique uniquement aux URLs HTTP (non-HTTPS). Les hôtes de cette liste peuvent s'ouvrir dans cmux sans avertissement. Les valeurs par défaut incluent localhost, 127.0.0.1, ::1, 0.0.0.0 et *.localtest.me.

Exemple de 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