Konfiguracja

imux odczytuje konfigurację z plików konfiguracyjnych Ghostty, dając Ci znajome opcje jeśli przechodzisz z Ghostty.

Lokalizacje plików konfiguracyjnych

imux szuka konfiguracji w tych lokalizacjach (w kolejności):

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

Utwórz plik konfiguracyjny jeśli nie istnieje:

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

Wygląd

Czcionka

font-family = JetBrains Mono
font-size = 14

Kolory

# 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

Dzielone panele

# 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

Zachowanie

Scrollback

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

Katalog roboczy

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

Ustawienia aplikacji

Ustawienia w aplikacji są dostępne przez imux > Ustawienia (⌘,):

Tryb motywu

• Systemowy: podążaj za wyglądem macOS
• Jasny: zawsze jasny tryb
• Ciemny: zawsze ciemny tryb

Tryb automatyzacji

Poziom dostępu do gniazda kontrolnego:

• Wyłączony: brak kontroli przez socket (najbezpieczniejszy)
• Tylko procesy imux: zezwalaj tylko procesom uruchomionym w terminalach imux na połączenie
• allowAll: zezwalaj dowolnemu lokalnemu procesowi na połączenie (ICC_SOCKET_MODE=allowAll, tylko nadpisanie zmiennej środowiskowej)

Zachowanie linków w przeglądarce

W Ustawieniach > Przeglądarka imux udostępnia dwie listy hostów o różnych zastosowaniach:

• Hosty do otwarcia we wbudowanej przeglądarce: dotyczy linków klikniętych z wyjścia terminala. Hosty na tej liście otwierają się w imux; pozostałe hosty otwierają się w domyślnej przeglądarce. Obsługuje jeden host lub wildcard na linię (na przykład: example.com, *.internal.example).
• Hosty HTTP dozwolone we wbudowanej przeglądarce: dotyczy tylko URL-i HTTP (nie-HTTPS). Hosty na tej liście mogą otwierać się w imux bez monitu ostrzegawczego. Domyślnie obejmuje localhost, 127.0.0.1, ::1, 0.0.0.0 i *.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.

Przykładowa konfiguracja

# 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