imux
imux

Konfiguration

imux liest die Konfiguration aus Ghostty-Konfigurationsdateien, was Ihnen vertraute Optionen bietet, wenn Sie von Ghostty kommen.

Speicherorte der Konfigurationsdatei

imux sucht an diesen Speicherorten nach Konfiguration (in dieser Reihenfolge):

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

Erstellen Sie die Konfigurationsdatei, falls sie nicht existiert:

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

Erscheinungsbild

Schriftart

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

Farben

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

Geteilte Bereiche

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

Verhalten

Scrollback

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

Arbeitsverzeichnis

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

App-Einstellungen

In-App-Einstellungen sind über imux > Einstellungen (⌘,) verfügbar:

Design-Modus

  • System: macOS-Erscheinungsbild folgen
  • Hell: Immer heller Modus
  • Dunkel: Immer dunkler Modus

Automatisierungsmodus

Zugriffsebene der Steuerungs-Socket:

  • Aus: Kein Socket-Zugriff (am sichersten)
  • Nur icc-Prozesse: Nur Prozesse, die in icc-Terminals gestartet wurden, können sich verbinden
  • allowAll: Jeden lokalen Prozess verbinden lassen (ICC_SOCKET_MODE=allowAll, nur per Umgebungsvariable)
Auf gemeinsam genutzten Rechnern sollten Sie den Modus "Aus" oder "Nur icc-Prozesse" verwenden.

Browser-Link-Verhalten

Unter Einstellungen > Browser stellt imux zwei Host-Listen mit unterschiedlichen Zwecken bereit:

  • Hosts im eingebetteten Browser öffnen: Gilt für Links, die aus der Terminal-Ausgabe geklickt werden. Hosts in dieser Liste öffnen sich in imux; andere Hosts öffnen sich in Ihrem Standardbrowser. Unterstützt einen Host oder Wildcard pro Zeile (zum Beispiel: example.com, *.internal.example).
  • Im eingebetteten Browser erlaubte HTTP-Hosts: Gilt nur für HTTP-URLs (nicht HTTPS). Hosts in dieser Liste können in imux ohne Warnhinweis geöffnet werden. Standardmäßig enthalten sind localhost, 127.0.0.1, ::1, 0.0.0.0 und *.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.
Readiness checks do not replace review. They tell you whether the workspace is configured enough to start; files, command output, browser state, and Git state still need human verification.

Beispielkonfiguration

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