cmuxcmux/docs

Configuración

cmux lee la configuración de archivos de configuración de Ghostty, ofreciéndole opciones familiares si viene de Ghostty.

Ubicaciones del archivo de configuración

cmux busca configuración en estas ubicaciones (en orden):

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

Cree el archivo de configuración si no existe:

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

Apariencia

Fuente

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

Colores

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

Paneles 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

Comportamiento

Scrollback

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

Directorio de trabajo

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

Configuración de la app

La configuración de la app está disponible a través de cmux > Configuración (⌘,):

Modo de tema

  • Sistema: seguir la apariencia de macOS
  • Claro: siempre modo claro
  • Oscuro: siempre modo oscuro

Modo de automatización

Nivel de acceso del socket de control:

  • Desactivado: sin acceso al socket (más seguro)
  • Solo procesos de cmux: solo los procesos iniciados dentro de terminales de cmux pueden conectarse
  • allowAll: permitir que cualquier proceso local se conecte (CMUX_SOCKET_MODE=allowAll, solo por variable de entorno)
En máquinas compartidas, considere usar el modo "Desactivado" o "Solo procesos de cmux".

Comportamiento de enlaces del navegador

En Configuración > Navegador, cmux expone dos listas de hosts con diferentes propósitos:

  • Hosts para abrir en el navegador integrado: se aplica a enlaces clicados desde la salida del terminal. Los hosts en esta lista se abren en cmux; otros hosts se abren en su navegador predeterminado. Soporta un host o comodín por línea (por ejemplo: example.com, *.internal.example).
  • Hosts HTTP permitidos en el navegador integrado: se aplica solo a URLs HTTP (no HTTPS). Los hosts en esta lista pueden abrirse en cmux sin un aviso de advertencia. Los valores predeterminados incluyen localhost, 127.0.0.1, ::1, 0.0.0.0 y *.localtest.me.

Configuración de ejemplo

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