Configuração

O imux lê a configuração dos arquivos de configuração do Ghostty, oferecendo opções familiares se você vem do Ghostty.

Locais do arquivo de configuração

O imux procura configuração nestes locais (em ordem):

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

Crie o arquivo de configuração se ele não existir:

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

Aparência

Fonte

font-family = JetBrains Mono
font-size = 14

Cores

# 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

Painéis divididos

# 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

Histórico de rolagem

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

Diretório de trabalho

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

Configurações do app

Configurações do app estão disponíveis via imux > Configurações (⌘,):

Modo de tema

• Sistema: seguir aparência do macOS
• Claro: sempre modo claro
• Escuro: sempre modo escuro

Modo de automação

Nível de acesso ao socket:

• Desligado: sem controle por socket (mais seguro)
• Apenas processos imux: permitir apenas processos iniciados dentro dos terminais do imux se conectarem
• allowAll: permitir qualquer processo local se conectar (ICC_SOCKET_MODE=allowAll, apenas por variável de ambiente)

Comportamento de links do navegador

Em Configurações > Navegador, o imux expõe duas listas de hosts com propósitos diferentes:

• Hosts para abrir no navegador integrado: aplica-se a links clicados na saída do terminal. Hosts nesta lista abrem no imux; outros hosts abrem no seu navegador padrão. Suporta um host ou wildcard por linha (por exemplo: example.com, *.internal.example).
• Hosts HTTP permitidos no navegador integrado: aplica-se apenas a URLs HTTP (não HTTPS). Hosts nesta lista podem abrir no imux sem aviso. Os padrões incluem 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.

Exemplo de configuração

# 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