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

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

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

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

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

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

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

Внешний вид

Шрифт

font-family = JetBrains Mono
font-size = 14

Цвета

# 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

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

# 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

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

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

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

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

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

Режим темы

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

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

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

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

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

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

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

Setup readiness

imux readiness indicators are the operator checklist before a long agent or remote workflow starts. They summarize whether the app can find the expected CLI tools, saved provider profiles, notification hooks, workspace folder, remote connection, and browser or source-control context.

• Fix missing provider profiles before asking the supervisor to plan work.
• Confirm agent CLIs run both in a normal shell and inside an imux terminal.
• Use notification hook warnings as setup debt, not as proof that the task cannot launch.

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

# 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