imux
imux

設定

imux 從 Ghostty 設定檔讀取設定，如果你是從 Ghostty 轉過來的，會覺得很熟悉。

設定檔位置

imux 會依序在以下位置尋找設定：

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

如果設定檔不存在，請建立它：

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

外觀

字型

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

顏色

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

分割窗格

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

行為

捲動回看

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

工作目錄

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

應用程式設定

應用程式內設定可透過 imux > 設定（⌘,）存取：

主題模式

  • 系統：跟隨 macOS 外觀
  • 淺色：始終使用淺色模式
  • 深色：始終使用深色模式

自動化模式

控制 socket 存取層級：

  • 關閉：停用 socket 控制（最安全）
  • 僅限 imux 程序：只允許在 imux 終端機內啟動的程序連線
  • allowAll：允許任何本機程序連線（ICC_SOCKET_MODE=allowAll，僅限環境變數覆寫）
在共用機器上，建議使用「關閉」或「僅限 imux 程序」模式。

瀏覽器連結行為

在「設定 > 瀏覽器」中，imux 提供兩個不同用途的主機列表：

  • 在內建瀏覽器中開啟的主機：適用於從終端機輸出點擊的連結。此列表中的主機會在 imux 中開啟；其他主機會在你的預設瀏覽器中開啟。支援每行一個主機或萬用字元（例如：example.com、*.internal.example）。
  • 內建瀏覽器中允許的 HTTP 主機：僅適用於 HTTP（非 HTTPS）URL。此列表中的主機可以在 imux 中開啟而不會出現警告提示。預設包含 localhost、127.0.0.1、::1、0.0.0.0 和 *.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.

範例設定

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