配置

imux 从 Ghostty 配置文件中读取配置，如果你之前使用 Ghostty，这些选项会很熟悉。

配置文件位置

imux 按以下顺序查找配置：

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

如果配置文件不存在，请创建：

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

外观

字体

font-family = JetBrains Mono
font-size = 14

颜色

# 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

分屏面板

# 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

行为

回滚缓冲区

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

工作目录

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

应用设置

应用内设置可通过 imux > Settings（⌘,）打开：

主题模式

• System：跟随 macOS 外观
• Light：始终使用浅色模式
• Dark：始终使用深色模式

自动化模式

控制 socket 访问级别：

• Off：禁用 socket 控制（最安全）
• imux processes only：仅允许在 imux 终端内启动的进程连接
• allowAll：允许任何本地进程连接（ICC_SOCKET_MODE=allowAll，仅通过环境变量覆盖）

浏览器链接行为

在 Settings > Browser 中，imux 提供两个用途不同的主机列表：

• 在内嵌浏览器中打开的主机：适用于从终端输出点击的链接。此列表中的主机在 imux 中打开；其他主机在默认浏览器中打开。支持单个主机或通配符，每行一个（例如：example.com、*.internal.example）。
• 内嵌浏览器允许的 HTTP 主机：仅适用于 HTTP（非 HTTPS）URL。此列表中的主机可以在 imux 中打开而不显示警告提示。默认包括 localhost、127.0.0.1、::1、0.0.0.0 和 *.localtest.me。

设置就绪度

imux 的就绪度提示是启动长时间 agent 或远程工作流前的操作检查表。它会概括应用是否能找到预期 CLI 工具、已保存的 provider 配置、通知 hook、工作区目录、远程连接，以及浏览器或源码状态上下文。

• 在要求监督器规划工作前，先补齐缺失的 provider 配置。
• 确认 agent CLI 在普通 shell 和 imux 终端内都能运行。
• 把通知 hook 警告当成设置债务，而不是任务一定不能启动的证据。

配置示例

# 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