設定

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 > 設定（⌘,）から利用できます：

テーマモード

• システム：macOSの外観に追従
• ライト：常にライトモード
• ダーク：常にダークモード

自動化モード

socketアクセスレベルの制御：

• オフ：socketを無効化（最も安全）
• imuxプロセスのみ：imuxターミナル内で起動されたプロセスのみ接続を許可
• allowAll：ローカルプロセスすべての接続を許可（ICC_SOCKET_MODE=allowAll、環境変数のみで設定）

ブラウザリンクの動作

設定 > ブラウザで、imuxは異なる目的の2つのホストリストを提供します：

• 組み込みブラウザで開くホスト：ターミナル出力からクリックしたリンクに適用されます。このリストのホストはimuxで開き、それ以外はデフォルトブラウザで開きます。1行に1つのホストまたはワイルドカードを指定できます（例：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.

設定例

# 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