cmuxcmux/docs

Configurazione

cmux legge la configurazione dai file di configurazione Ghostty, offrendoti opzioni familiari se provieni da Ghostty.

Posizione dei file di configurazione

cmux cerca la configurazione in queste posizioni (in ordine):

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

Crea il file di configurazione se non esiste:

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

Aspetto

Font

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

Colori

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

Pannelli divisi

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

Comportamento

Cronologia

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

Directory di lavoro

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

Impostazioni dell'app

Le impostazioni dell'app sono accessibili tramite cmux > Impostazioni (⌘,):

Modalità tema

  • Sistema: segui l'aspetto macOS
  • Chiaro: sempre in modalità chiara
  • Scuro: sempre in modalità scura

Modalità automazione

Livello di accesso al socket di controllo:

  • Disattivato: nessun accesso al socket (più sicuro)
  • Solo processi cmux: solo i processi avviati nei terminali cmux possono connettersi
  • allowAll: consenti a qualsiasi processo locale di connettersi (CMUX_SOCKET_MODE=allowAll, solo override tramite variabile d'ambiente)
Su macchine condivise, considera l'uso della modalità "Disattivato" o "Solo processi cmux".

Comportamento dei link del browser

In Impostazioni > Browser, cmux espone due liste di host con scopi diversi:

  • Host da aprire nel browser integrato: si applica ai link cliccati dall'output del terminale. Gli host in questa lista si aprono in cmux; gli altri host si aprono nel browser predefinito. Supporta un host o wildcard per riga (ad esempio: example.com, *.internal.example).
  • Host HTTP consentiti nel browser integrato: si applica solo agli URL HTTP (non-HTTPS). Gli host in questa lista possono aprirsi in cmux senza avviso. I valori predefiniti includono localhost, 127.0.0.1, ::1, 0.0.0.0 e *.localtest.me.

Esempio di configurazione

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