cmuxcmux/docs

Конфигурация

cmux читает конфигурацию из конфиг-файлов Ghostty, предоставляя знакомые опции если ты переходишь с Ghostty.

Расположение конфиг-файлов

cmux ищет конфигурацию в этих расположениях (по порядку):

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

Создай конфиг-файл если он не существует:

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

Внешний вид

Шрифт

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

Цвета

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

Разделённые панели

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

Поведение

Scrollback

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

Рабочая директория

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

Настройки приложения

Настройки в приложении доступны через cmux > Settings (⌘,):

Режим темы

  • Системный: следует за внешним видом macOS
  • Светлый: всегда светлая тема
  • Тёмный: всегда тёмная тема

Режим автоматизации

Уровень доступа к сокету:

  • Выключен: нет управления через socket (самый безопасный)
  • Только процессы cmux: только процессы, запущенные внутри терминалов cmux, могут подключаться
  • allowAll: любой локальный процесс может подключиться (CMUX_SOCKET_MODE=allowAll, только через переменную окружения)
На общих машинах используй режим "Выключен" или "Только процессы cmux".

Поведение ссылок браузера

В Настройки > Браузер, cmux предоставляет два списка хостов с разными целями:

  • Хосты для открытия во встроенном браузере: применяется к ссылкам, нажатым в выводе терминала. Хосты из этого списка открываются в cmux; остальные хосты открываются в твоём браузере по умолчанию. Поддерживает один хост или wildcard на строку (например: example.com, *.internal.example).
  • HTTP-хосты, разрешённые во встроенном браузере: применяется только к HTTP (не HTTPS) URL-ам. Хосты из этого списка могут открываться в cmux без предупреждения. По умолчанию включают localhost, 127.0.0.1, ::1, 0.0.0.0 и *.localtest.me.

Пример конфигурации

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