Configurazione

imux legge la configurazione dai file di configurazione Ghostty, offrendoti opzioni familiari se provieni da Ghostty.

Posizione dei file di configurazione

imux cerca la configurazione in queste posizioni (in ordine):

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

Crea il file di configurazione se non esiste:

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

Aspetto

Font

font-family = JetBrains Mono
font-size = 14

Colori

# 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

Pannelli divisi

# 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

Comportamento

Cronologia

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

Directory di lavoro

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

Impostazioni dell'app

Le impostazioni dell'app sono accessibili tramite imux > Impostazioni (⌘,):

Modalità tema

• Sistema: segui l'aspetto macOS
• Chiaro: sempre in modalità chiara
• Scuro: sempre in modalità scura

Modalità automazione

Livello di accesso al socket di controllo:

• Disattivato: nessun accesso al socket (più sicuro)
• Solo processi imux: solo i processi avviati nei terminali imux possono connettersi
• allowAll: consenti a qualsiasi processo locale di connettersi (ICC_SOCKET_MODE=allowAll, solo override tramite variabile d'ambiente)

Comportamento dei link del browser

In Impostazioni > Browser, imux espone due liste di host con scopi diversi:

• Host da aprire nel browser integrato: si applica ai link climuxati dall'output del terminale. Gli host in questa lista si aprono in imux; gli altri host si aprono nel browser predefinito. Supporta un host o wildcard per riga (ad esempio: example.com, *.internal.example).
• Host HTTP consentiti nel browser integrato: si applica solo agli URL HTTP (non-HTTPS). Gli host in questa lista possono aprirsi in imux senza avviso. I valori predefiniti includono localhost, 127.0.0.1, ::1, 0.0.0.0 e *.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.

Esempio di configurazione

# 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