Configuration

imux lit la configuration depuis les fichiers de configuration Ghostty, vous offrant des options familières si vous venez de Ghostty.

Emplacements des fichiers de configuration

imux cherche la configuration dans ces emplacements (dans l'ordre) :

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

Créez le fichier de configuration s'il n'existe pas :

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

Apparence

Police

font-family = JetBrains Mono
font-size = 14

Couleurs

# 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

Panneaux divisés

# 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

Comportement

Historique

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

Répertoire de travail

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

Paramètres de l'application

Les paramètres de l'application sont accessibles via imux > Réglages (⌘,) :

Mode de thème

• Système : suivre l'apparence macOS
• Clair : toujours en mode clair
• Sombre : toujours en mode sombre

Mode automatisation

Niveau d'accès au socket de contrôle :

• Désactivé : pas d'accès au socket (le plus sécurisé)
• Processus imux uniquement : seuls les processus démarrés dans les terminaux imux peuvent se connecter
• allowAll : autoriser tout processus local à se connecter (ICC_SOCKET_MODE=allowAll, remplacement par variable d'environnement uniquement)

Comportement des liens du navigateur

Dans Réglages > Navigateur, imux expose deux listes d'hôtes avec des objectifs différents :

• Hôtes à ouvrir dans le navigateur intégré : s'applique aux liens cliqués depuis la sortie du terminal. Les hôtes de cette liste s'ouvrent dans imux ; les autres hôtes s'ouvrent dans votre navigateur par défaut. Supporte un hôte ou un joker par ligne (par exemple : example.com, *.internal.example).
• Hôtes HTTP autorisés dans le navigateur intégré : s'applique uniquement aux URLs HTTP (non-HTTPS). Les hôtes de cette liste peuvent s'ouvrir dans imux sans avertissement. Les valeurs par défaut incluent localhost, 127.0.0.1, ::1, 0.0.0.0 et *.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.

Exemple de configuration

# 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