cmuxcmux/docs

Configuração

O cmux lê a configuração dos arquivos de configuração do Ghostty, oferecendo opções familiares se você vem do Ghostty.

Locais do arquivo de configuração

O cmux procura configuração nestes locais (em ordem):

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

Crie o arquivo de configuração se ele não existir:

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

Aparência

Fonte

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

Cores

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

Painéis divididos

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

Histórico de rolagem

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

Diretório de trabalho

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

Configurações do app

Configurações do app estão disponíveis via cmux > Configurações (⌘,):

Modo de tema

  • Sistema: seguir aparência do macOS
  • Claro: sempre modo claro
  • Escuro: sempre modo escuro

Modo de automação

Nível de acesso ao socket:

  • Desligado: sem controle por socket (mais seguro)
  • Apenas processos cmux: permitir apenas processos iniciados dentro dos terminais do cmux se conectarem
  • allowAll: permitir qualquer processo local se conectar (CMUX_SOCKET_MODE=allowAll, apenas por variável de ambiente)
Em máquinas compartilhadas, considere usar o modo "Desligado" ou "Apenas processos cmux".

Comportamento de links do navegador

Em Configurações > Navegador, o cmux expõe duas listas de hosts com propósitos diferentes:

  • Hosts para abrir no navegador integrado: aplica-se a links clicados na saída do terminal. Hosts nesta lista abrem no cmux; outros hosts abrem no seu navegador padrão. Suporta um host ou wildcard por linha (por exemplo: example.com, *.internal.example).
  • Hosts HTTP permitidos no navegador integrado: aplica-se apenas a URLs HTTP (não HTTPS). Hosts nesta lista podem abrir no cmux sem aviso. Os padrões incluem localhost, 127.0.0.1, ::1, 0.0.0.0 e *.localtest.me.

Exemplo de configuração

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