cmuxcmux/docs

設定

cmuxはGhosttyの設定ファイルから設定を読み込むため、Ghosttyから移行する場合は馴染みのあるオプションを使えます。

設定ファイルの場所

cmuxは以下の場所から設定を検索します（順番に）：

  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

アプリ設定

アプリ内設定はcmux > 設定（⌘,）から利用できます：

テーマモード

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

自動化モード

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

  • オフ：socketを無効化（最も安全）
  • cmuxプロセスのみ：cmuxターミナル内で起動されたプロセスのみ接続を許可
  • allowAll：ローカルプロセスすべての接続を許可（CMUX_SOCKET_MODE=allowAll、環境変数のみで設定）
共有マシンでは「オフ」または「cmuxプロセスのみ」モードの使用を検討してください。

ブラウザリンクの動作

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

  • 組み込みブラウザで開くホスト：ターミナル出力からクリックしたリンクに適用されます。このリストのホストはcmuxで開き、それ以外はデフォルトブラウザで開きます。1行に1つのホストまたはワイルドカードを指定できます（例：example.com、*.internal.example）。
  • 組み込みブラウザで許可するHTTPホスト：HTTP（非HTTPS）URLのみに適用されます。このリストのホストは警告プロンプトなしでcmuxで開けます。デフォルトはlocalhost、127.0.0.1、::1、0.0.0.0、*.localtest.meです。

設定例

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