# 設定

cmuxはターミナル設定をGhosttyの設定ファイルから読み込みます。cmux管理のアプリ設定も ~/.config/cmux/cmux.json で管理でき、ショートカット、自動化、サイドバー、通知、ブラウザ設定を含みます。

## 設定ファイルの場所

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 = SF Mono
font-size = 13
sidebar-font-size = 14
surface-tab-bar-font-size = 11
theme = One Dark
scrollback-limit = 50000000
split-divider-color = #3e4451
working-directory = ~/code
```

## cmux.json

cmux keeps app-owned settings, shortcuts, actions, custom commands, and workspace layouts in `~/.config/cmux/cmux.json`. Terminal rendering still lives in Ghostty config. On launch, if the file is missing, cmux writes a commented template there.

Open cmux Settings, then use the `cmux.json` section to open the canonical file in your preferred text editor.

1.  `~/.config/cmux/cmux.json`
2.  `.cmux/cmux.json` in a project for project-scoped actions and workspace commands

**Precedence:** global `~/.config/cmux/cmux.json` settings override values saved in the Settings window. Legacy `~/.config/cmux/settings.json` and Application Support settings files are read only as fallback for missing settings keys. Project-local `.cmux/cmux.json` can override actions, commands, UI action wiring, and notification hooks, but not global app preferences.

**Reload:** edit the file, then use `Cmd+Shift+,` or `cmux reload-config` to re-read it without restarting the app.

**Migrations:** keep `schemaVersion` at `1` for now. Future cmux versions will use that field for upgrades. If cmux sees a newer schema version, it logs a warning and parses known keys only.

The file accepts JSON with comments and trailing commas. The canonical schema is published at [https://raw.githubusercontent.com/manaflow-ai/cmux/main/web/data/cmux.schema.json](https://raw.githubusercontent.com/manaflow-ai/cmux/main/web/data/cmux.schema.json) and the source lives at [https://github.com/manaflow-ai/cmux/blob/main/web/data/cmux.schema.json](https://github.com/manaflow-ai/cmux/blob/main/web/data/cmux.schema.json).

~/.config/cmux/cmux.json

```
{
  "$schema": "https://raw.githubusercontent.com/manaflow-ai/cmux/main/web/data/cmux.schema.json",
  "schemaVersion": 1,

  // "app": {
  //   "appearance": "dark",
  //   "menuBarOnly": false,
  //   "newWorkspacePlacement": "afterCurrent",
  //   "windowTitleTemplate": "[cmux:{windowToken}] {activeWorkspace}",
  //   "paneResizeStepPixels": 20,
  //   "confirmQuit": "always",
  //   "openSupportedFilesInCmux": true,
  //   "workspaceInheritWorkingDirectory": true,
  //   "iMessageMode": true
  // },

  // "terminal": {
  //   "showScrollBar": false,
  //   "copyOnSelect": true,
  //   "autoResumeAgentSessions": true,
  //   "showTextBoxOnNewTerminals": false,
  //   "focusTextBoxOnNewTerminals": false,
  //   "agentHibernation": {
  //     "enabled": false,
  //     "idleSeconds": 5,
  //     "maxLiveTerminals": 12
  //   },
  //   "textBoxMaxLines": 10
  // },

  // "browser": {
  //   "defaultSearchEngine": "kagi",
  //   // For an unlisted provider, set "defaultSearchEngine": "custom" and fill these:
  //   "customSearchEngineName": "My Search",
  //   "customSearchEngineURLTemplate": "https://search.example.com/?q={query}",
  //   "openTerminalLinksInCmuxBrowser": true,
  //   "hostsToOpenInEmbeddedBrowser": ["localhost", "*.internal.example"]
  // },

  // "markdown": {
  //   // 新しく開く Markdown ビューアの本文フォントサイズ（ポイント単位）。
  //   // Cmd-+ / Cmd-- / Cmd-0 でその場で拡大・縮小できます。
  //   "fontSize": 15,
  //   // 本文フォントファミリーの既定値です。空のままにするとシステムの Markdown フォントスタックを使います。
  //   "fontFamily": "",
  //   // 読み取りカラム最大幅の既定値（CSS ピクセル単位）です。
  //   "maxWidth": 980
  // },

  // "fileEditor": {
  //   // 横スクロールする代わりに、エディタの右端で長い行を折り返します。
  //   "wordWrap": false
  // },

  // "fileExplorer": {
  //   // ファイルをダブルクリックしたときの動作: preview（既定）、defaultEditor（macOS の既定アプリ）、preferredEditor（app.preferredEditor コマンド）。
  //   "doubleClickAction": "preview"
  // },

  // "automation": {
  //   "suppressSubagentNotifications": true
  // },

  // "workspaceColors": {
  //   "colors": {
  //     "Red": "#C0392B",
  //     "Blue": "#1565C0",
  //     "Neon Mint": "#00F5D4"
  //   }
  // },

  // "workspaceGroups": {
  //   "newWorkspacePlacement": "afterCurrent"
  // },

  // "agentChat": {
  //   "url": "http://127.0.0.1:7739",
  //   "startCommand": "cmux-chat"
  // },

  // "shortcuts": {
  //   "bindings": {
  //     "toggleSidebar": "cmd+b",
  //     "toggleFileExplorer": "cmd+opt+b",
  //     "toggleFileEditorWordWrap": "opt+z",
  //     "newTab": ["ctrl+b", "c"],
  //     "commandPalettePrevious": null
  //   }
  // },
}
```

## Schema reference

This reference covers every supported global settings key in `cmux.json`. The embedded browser, terminal, sidebar, notifications, automation, and cmux-owned keyboard shortcuts all live here. Actions and workspace commands are documented on the [custom commands page](https://cmux.com/ja/docs/custom-commands).

### Metadata

`$schema`

Optional schema URL for editor completion and validation.

Type

`string`

Default

`"https://raw.githubusercontent.com/manaflow-ai/cmux/main/web/data/cmux.schema.json"`

`schemaVersion`

Schema version for forward-compatible migrations. Newer versions are parsed on a best-effort basis.

Type

`integer`

Default

`1`

### `app`

General app preferences from Settings > App.

`app.language`

Preferred app language.

Type

`string`

Default

`"system"`

Allowed values

`system, en, ar, bs, zh-Hans, zh-Hant, da, de, es, fr, it, ja, ko, nb, pl, pt-BR, ru, th, tr`

`app.appearance`

App appearance mode.

Type

`string`

Default

`"system"`

Allowed values

`system, light, dark`

`app.accentColor`

Accent for cmux-drawn chrome: the selected workspace, attention ring and pane flash, agent status, pane swap, canvas focus, and scroll markers. "cmux" uses cmux blue; "system" follows the macOS accent color and updates when it changes; a "#RRGGBB" hex uses that color in light and dark mode. workspaceColors.selectionColor and notifications.paneFlashColor still override their parts. Native controls always use the macOS accent.

Type

`string | unknown`

Default

`"cmux"`

`app.appIcon`

Dock and app switcher icon style.

Type

`string`

Default

`"automatic"`

Allowed values

`automatic, light, dark`

`app.windowTitleTemplate`

任意の NSWindow タイトルテンプレートです。空欄のままなら、現在のディレクトリへのフォールバックを含む cmux 既存の既定タイトル動作を保ちます。対応するプレースホルダー: {windowId}, {windowToken}, {activeWorkspace}, {activeDirectory}, {defaultTitle}, {appName}。

Type

`string`

Default

`""`

`app.devWindowDisplay`

新しいウィンドウを開くときに DEBUG ビルドでのみ使用するディスプレイ名です。空の値ではシステムのデフォルトを使用します。

Type

`string`

Default

`""`

`app.menuBarOnly`

Hide the Dock icon and app switcher entry while keeping cmux available from the menu bar.

Type

`boolean`

Default

`false`

`app.newWorkspacePlacement`

Where new workspaces are inserted in the sidebar.

Type

`string`

Default

`"afterCurrent"`

Allowed values

`top, afterCurrent, end`

`app.goToWorkspaceOrder`

Order used by Go to Workspace (Cmd-P): sidebar order, or most recently focused workspaces.

Type

`string`

Default

`"sidebar"`

Allowed values

`sidebar, recent`

`app.forkConversationDefaultDestination`

タブのコンテキストメニューにある主要な「会話をフォーク」操作のデフォルトのフォーク先です。サブメニューには引き続きすべてのフォーク先が表示されます。

Type

`string`

Default

`"right"`

Allowed values

`right, left, top, bottom, newTab, newWorkspace`

`app.workspaceInheritWorkingDirectory`

When true, new workspaces inherit the current workspace working directory. When false, new workspaces use Ghostty's working-directory setting instead.

Type

`boolean`

Default

`true`

`app.minimalMode`

Hide the workspace title bar and move controls into the sidebar.

Type

`boolean`

Default

`false`

`app.keepWorkspaceOpenWhenClosingLastSurface`

When true, closing the last surface keeps the workspace open.

Type

`boolean`

Default

`false`

`app.focusPaneOnFirstClick`

When cmux is inactive, the first click can activate and focus the clicked pane.

Type

`boolean`

Default

`false`

`app.paneResizeStepPixels`

ペインのリサイズショートカットを1回押すごとに移動するピクセル数。範囲は 1～200、既定値は 20 です。変更はすぐに適用されます。

Type

`integer`

Default

`20`

`app.focusHistoryIncludesPanesAndTabs`

When true, Back and Forward include focus changes between panes and tabs. When false, they navigate between workspaces only.

Type

`boolean`

Default

`false`

`app.equalizeSplitsOnCreate`

When true, creating a split resizes the panes in that split's row or column to equal sizes. When false, a new split halves the pane it was created from.

Type

`boolean`

Default

`false`

`app.preferredEditor`

Custom editor command used when Cmd-click file previews are disabled or a file is unsupported. Leave empty to use the default.

Type

`string`

Default

`""`

`app.defaultWorkspacePath`

Folder the Open Folder panel starts in, for example ~/code. Supports a leading ~. Leave empty to start in the active workspace's directory.

Type

`string`

Default

`""`

`app.openSupportedFilesInCmux`

When enabled, Cmd-clicking readable local files opens supported previews in cmux, including text, code, PDFs, images, audio, video, and Quick Look files. Preview headers include an Open With menu based on the user's default and compatible macOS apps for that file.

Type

`boolean`

Default

`true`

`app.openMarkdownInCmuxViewer`

When enabled, Cmd-clicking .md/.markdown/.mkd/.mdx files opens the rendered cmux markdown viewer panel (with live reload) instead of the generic file preview.

Type

`boolean`

Default

`true`

`app.globalFontMagnification`

cmux が自前で描画するすべての要素（ターミナルのテキスト、タブのタイトル、サイドバー、設定、オーバーレイ、ウィンドウの枠）の表示倍率をパーセントで指定します。ブラウザサーフェス内の Web ページは独自のサイズを保ちます。

Type

`integer`

Default

`100`

`app.reorderOnNotification`

Automatic workspace reordering. true or "notifications" moves workspaces with new notifications toward the top. "agentActivity" also moves them when a prompt is sent or an agent finishes a turn, needs input, or fails, at most once per burst and never while the pointer is over the sidebar. false or "off" keeps the order stable.

Type

`boolean | string`

Default

`true`

`app.iMessageMode`

Move a workspace to the top and show the submitted message when sending an agent prompt.

Type

`boolean`

Default

`false`

`app.sendAnonymousTelemetry`

Allow anonymous telemetry.

Type

`boolean`

Default

`true`

`app.confirmQuit`

cmux の終了前に確認を求めるタイミングを制御します。DEV ビルドではこの設定に関係なく常にすぐ終了します。従来の app.warnBeforeQuit も boolean フォールバックとして引き続き受け付けます。

Type

`string`

Default

`"always"`

Allowed values

`always, dirty-only, never`

`app.warnBeforeQuit`

終了確認用の従来の boolean フォールバックです。新しい設定では app.confirmQuit を使ってください。

Type

`boolean`

Default

`true`

`app.warnBeforeClosingTab`

Show a confirmation before closing a tab.

Type

`boolean`

Default

`true`

`app.warnBeforeClosingAgentSession`

Show a confirmation before closing an agent session while it is mid-turn.

Type

`boolean`

Default

`true`

`app.warnBeforeClosingTabXButton`

タブの閉じるボタンでタブを閉じる前に確認を表示します。

Type

`boolean`

Default

`false`

`app.warnBeforeClosingWorkspace`

Show a confirmation before closing a workspace with a running process, or several workspaces at once. Pinned workspaces still ask when this is off.

Type

`boolean`

Default

`true`

`app.warnBeforeClosingWindow`

Show a confirmation before closing a window with a running process, or all of a window's workspaces at once.

Type

`boolean`

Default

`true`

`app.hideTabCloseButton`

ペインのタブバーでタブの閉じるボタンを非表示にします。

Type

`boolean`

Default

`false`

`app.tabBarVisibility`

ペインがタブバーを描画するタイミングを決めます。"always" はタブが 1 つだけのペインでも描画し、"multiple-tabs" はペインのタブが 1 つの間は隠し、2 つ目のタブが開かれた時点で描画します。ミニマルモード (app.minimalMode) では常に描画されます。最上部のペインのタブバーがウインドウのタイトルバーを兼ねているためです。

Type

`string`

Default

`"always"`

Allowed values

`always, multiple-tabs`

`app.renameSelectsExistingName`

Select the current name when opening rename flows.

Type

`boolean`

Default

`true`

`app.commandPaletteSearchesAllSurfaces`

Search every surface in the command palette switcher instead of only the active workspace.

Type

`boolean`

Default

`false`

### `terminal`

Terminal presentation settings from Settings > Terminal.

`terminal.adaptiveDefaultTheme`

true（既定）の場合、Ghostty のテーマやターミナルの色が設定されていなければ、外観に追従する既定のパレットを適用します。フォントなどの設定は保持されます。false の場合は Ghostty の固定された組み込みパレットを使用します。theme = light:X,dark:Y を含め、明示的なテーマと色の設定が常に優先されます。

Type

`boolean`

Default

`true`

`terminal.showScrollBar`

Show the right-edge terminal scroll bar when scrollback is available. cmux automatically suppresses it for alternate-screen style TUI surfaces.

Type

`boolean`

Default

`true`

`terminal.scrollSpeed`

マウスホイールやトラックパッドのスクロールイベント 1 回あたりにターミナルが移動する量を調整します。1 より大きい値でスクロールが速くなり、1 より小さい値で遅くなります。

Type

`number`

Default

`1`

`terminal.sessionContentMaxWidth`

ターミナルと組み込みエージェントチャットのコンテンツ幅の上限をポイント単位で指定します。ペインの全幅を使うには false を設定します。

Type

`boolean | number`

Default

`false`

`terminal.sessionContentAlignment`

sessionContentMaxWidth が有効な場合の、ターミナルと組み込みエージェントチャットの水平方向の配置です。

Type

`string`

Default

`"center"`

Allowed values

`left, center, right`

`terminal.copyOnSelect`

true の場合、選択が確定したときにターミナルで選択したテキストをシステムクリップボードへコピーします。false の場合、cmux は Ghostty の copy-on-select 上書きを出力せず、選択クリップボードの動作は Ghostty の設定と既定値に従います。

Type

`boolean`

Default

`false`

`terminal.showCopyConfirmation`

Briefly show "Copied to clipboard" at the bottom of a terminal after selecting text copies it. Applies whether copyOnSelect or Ghostty's copy-on-select turned copying on. Copies made with a keyboard shortcut or by a program (OSC 52) never show it.

Type

`boolean`

Default

`false`

`terminal.reflowHardWrapOnCopy`

When true, copying terminal text also joins a line that exactly fills the terminal width onto the next line, undoing hard wraps a program inserted at the grid edge. Soft-wrapped rows are always joined.

Type

`boolean`

Default

`false`

`terminal.confirmUnsafePaste`

When true, a paste that Ghostty's clipboard-paste-protection flags as unsafe (for example, text with a line break going to a program that has not enabled bracketed paste) waits for confirmation in a sheet attached to the terminal's window. When false, cmux pastes it without asking. OSC 52 clipboard reads are not affected.

Type

`boolean`

Default

`false`

`terminal.textEditingGestures`

Replay macOS text-editing gestures as line-editor keys at the shell prompt: Command and Option arrow keys move by line and word, and Command and Option Delete kill by line and word. While a full-screen application (vim, less, htop, tmux) has the terminal on the alternate screen, it gets the keys as if gestures were off, unless textEditingGesturesInFullScreenApps is on. Ghostty's own bindings still apply there, so Command+Left sends Ctrl+A and Option+Left sends Esc b.

Type

`boolean`

Default

`false`

`terminal.textEditingCommandMovesByWord`

With textEditingGestures on, switch to a browser-style layout: Command arrow and Delete keys move and delete by word, like Option, and Control+Left/Right move to the start and end of the line. Every other Control chord, including Ctrl+W and Ctrl+C, still reaches the terminal. macOS reserves Control+Left/Right for switching Spaces by default; turn those off in System Settings > Keyboard > Keyboard Shortcuts > Mission Control for Control+arrows to reach cmux.

Type

`boolean`

Default

`false`

`terminal.textEditingGesturesInFullScreenApps`

Keep textEditingGestures active while a full-screen application has the terminal on the alternate screen. tmux, screen, and zellij keep the outer terminal on the alternate screen even at their shell prompt, so turn this on to use gestures inside a multiplexer. Applications that bind the gesture chords themselves then receive the translated keys.

Type

`boolean`

Default

`false`

`terminal.showPasswordInputIndicator`

Show a lock badge in the terminal corner while the foreground program has turned echo off for a password prompt (sudo, ssh, passwd, gpg). cmux draws the badge itself and never changes terminal text. Only prompts on the local terminal are detected: an ssh password prompt counts, but sudo run inside an ssh session does not. Changes apply to an open prompt at once.

Type

`boolean`

Default

`true`

`terminal.showPasswordInputDots`

When the password input badge is shown, also draw one dot per typed character. cmux keeps only a count, never the typed characters. Backspace removes a dot; Enter or echo turning back on clears them. Pasted text is not counted.

Type

`boolean`

Default

`false`

`terminal.showJumpToBottomButton`

Removed. cmux no longer shows a Jump to Bottom button in terminal panes, and ignores this key. It stays in the schema so existing configs still validate.

Type

`boolean`

Default

`none`

`terminal.predictiveLocalEcho`

Draw typed characters immediately in a terminal whose shell runs on another machine (cmux ssh, Cloud, remote tmux) when the link is slow, underlined until the remote echo confirms them, and withdraw them if the remote disagrees. Local terminals, password prompts and full-screen apps are excluded.

Type

`boolean`

Default

`true`

`terminal.autoResumeAgentSessions`

Automatically run agent resume commands for restored terminal sessions when cmux reopens after quit. Set false to restore panes while keeping Claude Code, Codex, OpenCode, and other saved agent sessions idle until you resume them manually.

Type

`boolean`

Default

`true`

`terminal.showTextBoxOnNewTerminals`

新しいワークスペース、ターミナルタブ、ターミナル分割でTextBox 入力を既定で表示します。

Type

`boolean`

Default

`false`

`terminal.focusTextBoxOnNewTerminals`

新しいワークスペース、ターミナルタブ、ターミナル分割でTextBox 入力に既定でフォーカスします。フォーカスする場合は TextBox も表示されます。

Type

`boolean`

Default

`false`

`terminal.agentHibernation`

通常のエージェント休止の設定です。cmux はアイドル中のバックグラウンドエージェントプロセスを終了して RAM と CPU を解放し、そのタブを開いたときに保存済みセッションから再開します。通常の休止には、再開可能なコーディングエージェントであること、ライフサイクルがアイドルと報告していること、ターミナルが画面外にあること、ライブターミナル数が設定上限を超えていること、アイドル時間と確認時間を通して出力が変化していないことが必要です。これとは別に、メモリ負荷が高い状態（macOS または cmux アプリ自身のメモリ使用量によるメモリ負荷が危険な状態、あるいは cmux 全体のメモリ使用量が集計警告しきい値を超えた状態）では、enabled が false でも、cmux が安全なアイドル中のバックグラウンドエージェントをすべて休止する場合があります。表示中、実行中、入力待ち、最近変更された、またはトランスクリプトを保護できないエージェントは対象外です。プレースホルダーの「再開」ボタンは手動の代替手段です。

Type

`object`

Default

`none`

`terminal.rendererRealization`

Reclaim off-screen terminal GPU renderer memory. cmux releases the Metal renderer (IOSurface) of a terminal that has stayed off-screen and idle while keeping its process and terminal state alive, then rebuilds the renderer instantly when the tab is visited again. Non-destructive and on by default.

Type

`object`

Default

`none`

`terminal.titleUpdates`

Terminal title update throttling and diagnostics.

Type

`object`

Default

`none`

`terminal.runawayMemoryGuardrail`

Per-pane process-tree memory monitoring.

Type

`object`

Default

`none`

`terminal.textBoxMaxLines`

Maximum number of lines the rich terminal TextBox input can grow to before it scrolls.

Type

`integer`

Default

`10`

`terminal.textBoxDefaultSubmitAction`

新しいターミナルセッションで使う既定の TextBox 送信アクション ID です。通常の入力には text-entry、または設定済みアクション ID のいずれかを使います。

Type

`string`

Default

`"text-entry"`

`terminal.textBoxSubmitActions`

送信ボタン、Shift-Tab の切り替え、右クリックメニューに表示する設定可能な TextBox 送信アクションです。

Type

`array<object>`

Default

```
[]
```

`terminal.resumeCommands`

Signed command-prefix approvals for restoring non-agent terminal surfaces. cmux writes this list when you approve a surface resume command.

Type

`array<object>`

Default

```
[]
```

`terminal.uploadCommands`

Host-scoped rules that replace the built-in scp for terminal file drops and pastes over SSH. When the ssh destination matches a rule, cmux runs that rule's command once per file instead of scp, and inserts the command's stdout at the cursor (verbatim, with control characters stripped); if the command prints nothing, cmux inserts the shell-escaped remote path it chose instead. Per-file outputs are space-joined. First matching enabled rule wins; no match runs the built-in scp unchanged. A non-zero exit, timeout, or cancel inserts nothing.

Type

`array<object>`

Default

```
[]
```

### `notifications`

Notification behavior from Settings > Notifications.

`notifications.dockBadge`

Show the unread count in the Dock tile.

Type

`boolean`

Default

`true`

`notifications.showInMenuBar`

Show the menu bar extra.

Type

`boolean`

Default

`true`

`notifications.unreadPaneRing`

Highlight panes with unread notifications.

Type

`boolean`

Default

`true`

`notifications.paneFlash`

Flash the focused pane when requested.

Type

`boolean`

Default

`true`

`notifications.paneFlashDoubleBlink`

Blink the pane flash twice instead of one short pulse.

Type

`boolean`

Default

`true`

`notifications.paneFlashOnTyping`

Flash the pane when terminal typing dismisses its notification.

Type

`boolean`

Default

`true`

`notifications.paneFlashThemeColor`

Use the terminal theme foreground for flashes when paneFlashColor is unset. Unread rings remain cmux blue.

Type

`boolean`

Default

`false`

`notifications.paneFlashColor`

ペインのフラッシュと未読通知リングの色を上書きします。未設定の場合は app.accentColor のアクセントカラーを使用します。

Type

`unknown`

Default

`null`

`notifications.soundWhenFocused`

通知を送ったペインがすでにフォーカスされている場合でも通知音を鳴らします。既定ではオフで、フォーカス中のペインはリングとフラッシュのみを表示します。

Type

`boolean`

Default

`false`

`notifications.suppressOnlyFocusedSurface`

有効にすると、通知バナーはその対象がまさにフォーカス中のサーフェスである場合のみ自動的に取り下げられます。現在表示中のワークスペース内でフォーカスされていないサーフェス向けに配信されたバナーは、ワークスペースが表示されたときに取り消されるのではなく、そのサーフェスをフォーカスする（またはクリック／消去する）まで表示され続けます。オフの場合は従来のワークスペース表示時の取り下げ動作を維持します。

Type

`boolean`

Default

`false`

`notifications.suppressWhenAppFocused`

有効にすると、cmux がアクティブなアプリである間は、フォーカス中のペインだけでなくすべての通知でデスクトップバナーを省略します。通知はサイドバーに引き続き表示され、サウンドとカスタムコマンドも実行され、スマートフォンへの転送は変わりません。オフの場合、cmux にフォーカスがあっても他のワークスペースやペインのバナーは表示されます。

Type

`boolean`

Default

`false`

`notifications.agentPermissionPrompt`

エージェント（Claude Code など）がツールの実行にあなたの許可を待って停止しているときに通知します。エージェントの停止を解除するには操作が必要なため、既定でオンです。

Type

`boolean`

Default

`true`

`notifications.agentTurnComplete`

エージェントがターンを終えたことを通知するタイミングです。whenIdle（既定）は、実行中のバックグラウンドタスクや保留中のスケジュール再開が残っている間は通知を抑制し、作業が完全に片付いてから通知します。always はターン終了ごとに通知し、never は通知しません。

Type

`string`

Default

`"whenIdle"`

Allowed values

`whenIdle, always, never`

`notifications.agentIdleReminder`

エージェントがあなたの入力を待って待機状態になったとき（ターン終了の約60秒後）に通知します。前のターンのバックグラウンド作業がまだ実行中の間は抑制されるため、ビルドやウォッチャーの実行中に誤った待機通知が出ることはありません。

Type

`boolean`

Default

`true`

`notifications.sound`

Notification sound preset.

Type

`string`

Default

`"default"`

Allowed values

`default, Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, Tink, custom_file, none`

`notifications.customSoundFilePath`

Local path to the custom notification sound file.

Type

`string`

Default

`""`

`notifications.soundOverrides`

エージェントとアラート種別ごとの通知サウンド上書きです。空のセルは notifications.sound を使用します。

Type

`object`

Default

```
{}
```

`notifications.command`

Optional shell command to run alongside notification delivery.

Type

`string`

Default

`""`

`notifications.hooksMode`

Controls whether project-local notification hooks append to inherited hooks or replace them.

Type

`string`

Default

`"append"`

Allowed values

`append, replace`

`notifications.hooks`

Composable shell hooks that receive notification policy JSON on stdin and return updated policy JSON on stdout.

Type

`array<object>`

Default

```
[]
```

### `sidebar`

Sidebar content and metadata visibility from Settings > Sidebar.

`sidebar.fontSize`

Sidebar font size in points. The legacy Ghostty key sidebar-font-size remains a fallback alias.

Type

`number`

Default

`12.5`

`sidebar.hideAllDetails`

Hide all per-workspace detail rows.

Type

`boolean`

Default

`false`

`sidebar.wrapWorkspaceTitles`

Allow workspace titles in the sidebar to wrap to multiple lines instead of truncating after one line.

Type

`boolean`

Default

`false`

`sidebar.showWorkspaceDescription`

Show custom workspace descriptions in the sidebar.

Type

`boolean`

Default

`true`

`sidebar.workspaceDescriptionColor`

Override the workspace description text color in the sidebar.

Type

`unknown`

Default

`null`

`sidebar.beta`

Experimental sidebar features.

Type

`object`

Default

`none`

`sidebar.branchLayout`

Show git branch details stacked vertically or inline.

Type

`string`

Default

`"vertical"`

Allowed values

`vertical, inline`

`sidebar.branchVerticalLayout`

Show git branch details stacked vertically when true, or inline when false. This boolean form is the canonical setting; branchLayout remains supported as a legacy alias.

Type

`boolean`

Default

`true`

`sidebar.stackBranchDirectory`

Render the git branch and working directory on separate lines instead of sharing one line.

Type

`boolean`

Default

`false`

`sidebar.pathLastSegmentOnly`

Truncate sidebar paths from the start, showing as much of the trailing path as fits with a leading …/. When false, full paths are abbreviated with ~/.

Type

`boolean`

Default

`false`

`sidebar.showNotificationMessage`

Show the latest notification text in the sidebar.

Type

`boolean`

Default

`true`

`sidebar.notificationMessageLineLimit`

各ワークスペースタイトルの下に表示する最新通知の最大行数です。

Type

`integer`

Default

`12`

`sidebar.showBranchDirectory`

Show the workspace working directory.

Type

`boolean`

Default

`true`

`sidebar.showCloudDeviceIcons`

Git ブランチやディレクトリの詳細とは別に、リモートワークスペースのタイトルの横に Cloud コンピュータとデバイスのアイコンを表示します。

Type

`boolean`

Default

`true`

`sidebar.showPullRequests`

Show pull request metadata in the sidebar.

Type

`boolean`

Default

`true`

`sidebar.watchGitStatus`

Watch repository files for sidebar branch and pull request metadata without polling git.

Type

`boolean`

Default

`true`

`sidebar.makePullRequestsClickable`

Allow sidebar pull request metadata to open links when clicked.

Type

`boolean`

Default

`true`

`sidebar.openPullRequestLinksInCmuxBrowser`

Open sidebar pull request links in the embedded cmux browser.

Type

`boolean`

Default

`true`

`sidebar.openPortLinksInCmuxBrowser`

Open sidebar port links in the embedded cmux browser.

Type

`boolean`

Default

`true`

`sidebar.showSSH`

Show SSH connection details.

Type

`boolean`

Default

`true`

`sidebar.showPorts`

Show listening ports.

Type

`boolean`

Default

`true`

`sidebar.showLog`

Show recent log snippets.

Type

`boolean`

Default

`true`

`sidebar.showProgress`

Show progress indicators.

Type

`boolean`

Default

`true`

`sidebar.showAgentUsage`

Claude Code または Codex のステータス項目にコーディングエージェントの使用状況を追加します。モデルと使用中のコンテキストウィンドウ、さらに Claude Code では Anthropic の公開価格に基づく API コストの概算（メインスレッドとサブエージェント）を表示します。この金額は概算であり、サブスクリプションの請求額ではありません。バッチ／優先ティア、パートナー価格、高速モード、サーバーツールの料金は考慮していません。

Type

`boolean`

Default

`false`

`sidebar.showAgentActivity`

Show the loading spinner on workspaces with running coding agents or active loaders.

Type

`boolean`

Default

`true`

`sidebar.loadingSpinnerPosition`

Which side of the workspace row the loading spinner appears on: leading (left, sharing the unread-badge slot) or trailing (right).

Type

`string`

Default

`"leading"`

Allowed values

`leading, trailing`

`sidebar.notificationBadgePosition`

Which side of the workspace row the unread notification badge appears on: leading (left) or trailing (right).

Type

`string`

Default

`"leading"`

Allowed values

`leading, trailing`

`sidebar.showCustomMetadata`

Show custom metadata pills.

Type

`boolean`

Default

`true`

`sidebar.compactAgentStatus`

各ワークスペースを1行で表示します。タイトルの前の色付きアイコン1つがエージェント、未読、プルリクエストの状態を示し、エージェントの状態行（「実行中」や「入力待ち」など）、ブランチとディレクトリの行、プルリクエストの行を置き換えます。それらの詳細はアイコンのツールチップに移ります。その他のステータス項目は独自の行のまま表示されます。

Type

`boolean`

Default

`false`

`sidebar.compactStatusIcons`

compactAgentStatus のグリフを状態ごとに置き換える SF Symbol 名です（例: {"terminal": "apple.terminal", "needsInput": "hand.raised.fill"}）。未設定の状態は組み込みのシンボルを使い、表示できない名前も組み込みのシンボルに戻ります。

Type

`object`

Default

```
{}
```

`sidebar.activeTabIndicatorStyle`

Active workspace indicator style in the sidebar.

Type

`string`

Default

`"leftRail"`

Allowed values

`leftRail, solidFill, rail, border, wash, lift, typography, washRail, blueWashColorRail`

`sidebar.selectionColor`

Override the selected workspace background color in the sidebar.

Type

`unknown`

Default

`null`

`sidebar.notificationBadgeColor`

Override the unread notification badge color in the sidebar.

Type

`unknown`

Default

`null`

`sidebar.rightMaxWidth`

右サイドバーの最大幅（ポイント）。省略すると、組み込みの動的上限が適用されます。

Type

`number`

Default

`none`

### `workspaceGroups`

Per-cwd customization for sidebar workspace groups. The anchor workspace's cwd is matched against the keys in \`byCwd\`; longest-match wins. Keys containing \`\*\` or \`?\` are matched as fnmatch globs (with \`~\` expanded); other keys are path prefixes.

`workspaceGroups.newWorkspacePlacement`

グループ内で Cmd-N、グループヘッダーの + ボタン、設定済みグループアクションが新しいワークスペースを配置する場所のグローバル既定値です: \`afterCurrent\` (アクティブなグループ内ワークスペースの直後。ない場合は top)、\`top\` (アンカー直後の2番目の位置)、\`end\` (最後のメンバーの後)。

Type

`string`

Default

`"afterCurrent"`

Allowed values

`afterCurrent, top, end`

`workspaceGroups.byCwd`

Map of cwd patterns to group customization. Empty when omitted.

Type

`object`

Default

`none`

### `workspaceColors`

Workspace tab and badge colors from Settings > Workspace Colors.

`workspaceColors.indicatorStyle`

Active workspace indicator style. Legacy aliases are accepted and normalized.

Type

`string`

Default

`"leftRail"`

Allowed values

`leftRail, solidFill, rail, border, wash, lift, typography, washRail, blueWashColorRail`

`workspaceColors.selectionColor`

Override the selected workspace background color.

Type

`unknown`

Default

`null`

`workspaceColors.subtleSelection`

Show the selected workspace as a faint accent tint with a thin edge instead of a solid fill. A custom selectionColor still uses a solid fill.

Type

`boolean`

Default

`false`

`workspaceColors.brightenInDarkMode`

Lighten workspace colors in dark mode so they stay readable on a dark sidebar. false shows colors exactly as chosen. Applies to the solidFill indicator; leftRail always lightens its rail.

Type

`boolean`

Default

`true`

`workspaceColors.notificationBadgeColor`

Override the unread notification badge color.

Type

`unknown`

Default

`null`

`workspaceColors.colors`

Full named workspace color palette. Include built-in entries you want to keep, remove keys to remove colors, and add more named entries to extend the picker.

Type

`object`

Default

```
{
  "Red": "#C0392B",
  "Crimson": "#922B21",
  "Orange": "#A04000",
  "Amber": "#7D6608",
  "Olive": "#4A5C18",
  "Green": "#196F3D",
  "Teal": "#006B6B",
  "Aqua": "#0E6B8C",
  "Blue": "#1565C0",
  "Navy": "#1A5276",
  "Indigo": "#283593",
  "Purple": "#6A1B9A",
  "Magenta": "#AD1457",
  "Rose": "#880E4F",
  "Brown": "#7B3F00",
  "Charcoal": "#3E4B5E"
}
```

`workspaceColors.paletteOverrides`

Legacy workspace color overrides for built-in palette names. Prefer workspaceColors.colors for new configs.

Type

`object`

Default

```
{}
```

`workspaceColors.customColors`

Legacy list of custom workspace colors. Prefer workspaceColors.colors for new configs.

Type

`array<unknown>`

Default

```
[]
```

`workspaceColors.colors` is the full palette. Keep the built-in keys you want, delete keys to remove colors from the picker, and add more named color entries to extend it. Older `paletteOverrides` and `customColors` files still parse during upgrades, but new files should use `colors`.

```
{
  "workspaceColors": {
    "colors": {
      "Red": "#C0392B",
      "Blue": "#1565C0",
      "Neon Mint": "#00F5D4"
    }
  }
}
```

### `sidebarAppearance`

Sidebar tint settings from Settings > Sidebar Appearance.

`sidebarAppearance.matchTerminalBackground`

Use the terminal background instead of the sidebar tint.

Type

`boolean`

Default

`true`

`sidebarAppearance.tintColor`

Base sidebar tint color used when light/dark overrides are not set.

Type

`unknown`

Default

`"#000000"`

`sidebarAppearance.lightModeTintColor`

Sidebar tint override for light appearance.

Type

`unknown`

Default

`null`

`sidebarAppearance.darkModeTintColor`

Sidebar tint override for dark appearance.

Type

`unknown`

Default

`null`

`sidebarAppearance.tintOpacity`

Sidebar tint opacity from 0 to 1. Note: this only controls the sidebar tint, not terminal/window transparency. For terminal background transparency or blur, set \`background-opacity\` and \`background-blur\` in \`~/.config/ghostty/config\` and run \`cmux reload-config\`.

Type

`number`

Default

`0.18`

### `automation`

Socket control and automation settings from Settings > Automation.

`automation.socketControlMode`

Socket control mode. Legacy aliases are accepted and normalized.

Type

`string`

Default

`"cmuxOnly"`

Allowed values

`off, cmuxOnly, automation, password, allowAll, openAccess, fullOpenAccess, notifications, full`

`automation.socketPassword`

Password for password-mode socket access. Use null or an empty string to clear it.

Type

`string | null`

Default

`""`

`automation.claudeCodeIntegration`

Enable cmux integration hooks for Claude Code.

Type

`boolean`

Default

`true`

`automation.codexIntegration`

Enable cmux integration hooks for Codex. When disabled, cmux no longer wraps the codex command but still tracks live Codex sessions it can observe.

Type

`boolean`

Default

`true`

`automation.canonicalAgentScratch`

Use a cmux-owned scratch directory for native agent panels, organized per session.

Type

`boolean`

Default

`false`

`automation.piIntegration`

Enable cmux integration hooks for Pi.

Type

`boolean`

Default

`true`

`automation.claudeBinaryPath`

Custom path to the claude binary.

Type

`string`

Default

`""`

`automation.workspaceAutoNaming`

エージェントの会話内容からワークスペースとタブの名前を自動生成するオプトイン機能です。有効にすると、cmux は対応エージェントの各バイナリを使ってセッションを短いタイトルに要約します。手動の名前変更が常に優先されます。

Type

`boolean`

Default

`false`

`automation.autoNamingAgent`

すべてのセッションの自動命名を行うエージェントを指定します。"auto"（既定）は各セッションをそのセッション自身のエージェントで命名します。任意のエージェントのスラッグ（claude、codex、grok、opencode、pi、omp など）を指定すると、他のエージェントのセッションも含めてすべての命名をそのエージェントが行います。実行できない、または未インストールのエージェントは各セッション自身のエージェントにフォールバックするため、命名が壊れることはありません。

Type

`string`

Default

`"auto"`

`automation.ripgrepBinaryPath`

Custom path to the ripgrep (rg) binary used by project search.

Type

`string`

Default

`""`

`automation.suppressSubagentNotifications`

ネストされた Codex または Claude の子エージェントからの表示される完了通知とステータス変更を抑制し、それらのイベントは Feed テレメトリに残します。

Type

`boolean`

Default

`true`

`automation.agentAutoResume`

再試行可能な上流エラー（モデルの容量不足、過負荷、接続切断）でターンが終了した cmux 起動のエージェントに、バックオフ付きで \`continue\` を送信します。人の入力を待っているターンは再開しません。

Type

`boolean`

Default

`true`

`automation.ampIntegration`

Amp 向けの cmux フックをオンまたはオフにします。オフにしても同梱のプラグインはインストールされたまま、何もしない状態になります。

Type

`boolean`

Default

`true`

`automation.cursorIntegration`

Enable cmux integration hooks for Cursor.

Type

`boolean`

Default

`true`

`automation.geminiIntegration`

Enable cmux integration hooks for Gemini.

Type

`boolean`

Default

`true`

`automation.kiroIntegration`

Enable cmux integration hooks for Kiro CLI.

Type

`boolean`

Default

`true`

`automation.kiroNotificationLevel`

Controls how many Kiro tool events appear in Feed.

Type

`string`

Default

`"standard"`

Allowed values

`minimal, standard, verbose`

`automation.portBase`

Starting value for workspace CMUX\_PORT assignments.

Type

`integer`

Default

`9100`

`automation.portRange`

Number of ports reserved per workspace.

Type

`integer`

Default

`10`

### `ui`

UI action wiring, including surface tab bar buttons and plus-button behavior. The plus-button context menu shows ui.newWorkspace.contextMenu (or the default items) followed by actions that opt in via newWorkspaceMenu.

`ui.newWorkspace`

New Workspace button behavior and context-menu wiring.

Type

`object`

Default

`none`

### `agentChat`

Agent Chat GUI サーバーの設定です。組み込みの「新しいエージェントチャット」アクションは、この URL をブラウザワークスペースで開き、先に /healthz を確認し、サーバーが停止している場合は設定した起動コマンドを実行できます。

`agentChat.url`

このマシン上の Agent Chat GUI サーバーのベース URL です。cmux はワークスペースを開く前に <url>/healthz を確認します。

Type

`string`

Default

`"http://127.0.0.1:7739"`

`agentChat.startCommand`

<url>/healthz に到達できない場合に Agent Chat サーバーを起動する任意のシェルコマンドです。cmux はユーザーの SHELL でデタッチ実行し、短い上限付き時間だけ healthz をポーリングしてから、どちらの場合もワークスペースを開きます。

Type

`string`

Default

`none`

`agentChat.keys`

Agent Chat Web UI のキーボード動作の上書き設定です。

Type

`object`

Default

`none`

`agentChat.fonts`

Agent Chat Web UI のフォント上書き設定です。省略した値は Ghostty と組み込み既定値にフォールバックします。

Type

`object`

Default

`none`

### `browser`

Embedded browser settings from Settings > Browser.

`browser.defaultSearchEngine`

ブラウザのアドレスバーでURLではない入力に使う既定の検索エンジンです。任意のプロバイダには custom と customSearchEngineURLTemplate を使います。

Type

`string`

Default

`"google"`

Allowed values

`google, duckduckgo, bing, kagi, startpage, brave, perplexity, exa, yahoo, ecosia, qwant, mojeek, wikipedia, github, baidu, yandex, custom`

`browser.customSearchEngineName`

defaultSearchEngine が custom のときに使う表示名です。

Type

`string`

Default

`""`

`browser.customSearchEngineURLTemplate`

defaultSearchEngine が custom のときに使う検索URLです。エンコード済み検索語にはクエリ用プレースホルダーまたは %s を含めます。省略すると cmux が URL に q= を追加します。

Type

`string`

Default

`"https://www.google.com/search?q={query}"`

`browser.showSearchSuggestions`

Show omnibar search suggestions.

Type

`boolean`

Default

`true`

`browser.theme`

Embedded browser theme.

Type

`string`

Default

`"system"`

Allowed values

`system, light, dark`

`browser.defaultZoomLevel`

新しく開いたブラウザページに適用されるデフォルトのページズーム倍率（1 = 100%）。ズームイン・ズームアウト・実際のサイズは引き続き各ページごとに調整できます。

Type

`number`

Default

`1`

`browser.discardHiddenWebViews`

Allow hidden browser tabs to release page memory. Scroll position, supported form input, and history are restored when recoverable.

Type

`boolean`

Default

`true`

`browser.hiddenWebViewDiscardMode`

How cmux picks hidden browser tabs to free. budget frees the tabs hidden longest once hidden tabs use more than hiddenWebViewMemoryBudgetMB; timer frees every tab hidden longer than hiddenWebViewDiscardDelaySeconds.

Type

`string`

Default

`"budget"`

Allowed values

`budget, timer`

`browser.hiddenWebViewMemoryBudgetMB`

Megabytes of memory hidden browser tabs may use before cmux frees the tabs hidden longest. Applies when hiddenWebViewDiscardMode is budget.

Type

`integer`

Default

`2048`

`browser.hiddenWebViewDiscardDelaySeconds`

Seconds a browser tab must stay hidden before cmux may free its page memory. In timer mode, every tab hidden this long is freed.

Type

`number`

Default

`300`

`browser.autoRestoreUnloadedPages`

Restore a browser page unloaded to save memory, or whose web process ended while hidden, as soon as its tab is shown. When false, the tab shows the page's last snapshot until you click Restore.

Type

`boolean`

Default

`true`

`browser.askWhereToSaveDownloads`

ブラウザのダウンロードを直接「ダウンロード」に保存せず、保存パネルを表示します。

Type

`boolean`

Default

`false`

`browser.showLinkHoverURL`

ポインタがリンク上にある間、またはリンクにキーボードフォーカスがある間、ブラウザペインの左下にリンク先を表示します。

Type

`boolean`

Default

`true`

`browser.openTerminalLinksInCmuxBrowser`

Open clicked terminal links in the embedded browser.

Type

`boolean`

Default

`true`

`browser.interceptTerminalOpenCommandInCmuxBrowser`

Intercept terminal open http(s) commands and route them through the embedded browser.

Type

`boolean`

Default

`true`

`browser.hostsToOpenInEmbeddedBrowser`

Allowlist of hosts that should stay inside the embedded browser.

Type

`array<string>`

Default

```
[]
```

`browser.urlsToAlwaysOpenExternally`

Rules that always open matching URLs in the system browser.

Type

`array<string>`

Default

```
[]
```

`browser.insecureHttpHostsAllowedInEmbeddedBrowser`

HTTP hosts allowed in the embedded browser without a warning prompt.

Type

`array<string>`

Default

```
[
  "localhost",
  "*.localhost",
  "127.0.0.1",
  "::1",
  "0.0.0.0",
  "*.localtest.me"
]
```

`browser.urlAllowlist`

内蔵ブラウザの移動を制限するホストまたはURLパターンです。設定画面ではローカル開発用オリジンを候補として表示します。リストを保存すると任意の制限が有効になり、エントリを削除するとそのURLをブロックします。管理ポリシーがない場合はユーザー値を空にすると無効になります。

Type

`array<string>`

Default

```
[
  "localhost",
  "*.localhost",
  "127.0.0.1",
  "::1",
  "0.0.0.0",
  "*.localtest.me"
]
```

`browser.showImportHintOnBlankTabs`

Show the browser import hint on blank tabs.

Type

`boolean`

Default

`true`

`browser.reactGrabVersion`

Pinned react-grab version for the browser toolbar helper.

Type

`string`

Default

`"0.1.29"`

### `markdown`

Built-in markdown viewer settings.

`markdown.fontSize`

新しく開く Markdown ビューアの本文フォントサイズの既定値（ポイント単位）です。Cmd-+ / Cmd-- / Cmd-0 でその場で拡大・縮小できます。

Type

`integer`

Default

`15`

`markdown.fontFamily`

新しく開く Markdown ビューアの本文フォントファミリーの既定値です。空のままにするとシステムの Markdown フォントスタックを使います。

Type

`string`

Default

`""`

`markdown.maxWidth`

新しく開く Markdown ビューアの読み取りカラム最大幅の既定値（CSS ピクセル単位）です。

Type

`integer`

Default

`980`

### `fileEditor`

Built-in file editor settings.

`fileEditor.wordWrap`

エディタの幅より長い行をソフト折り返しして、横スクロールを不要にします。

Type

`boolean`

Default

`false`

`fileEditor.syntaxHighlighting`

内蔵ファイルエディタで開いたコードに、言語に応じた色分けを適用します。

Type

`boolean`

Default

`true`

`fileEditor.lineNumbers`

内蔵ファイルエディタで、本文の横の列に各行の番号を表示します。

Type

`boolean`

Default

`true`

`fileEditor.indentGuides`

内蔵ファイルエディタで、インデントの各レベルを細い縦線で示します。

Type

`boolean`

Default

`true`

`fileEditor.currentLineHighlight`

何も選択していないとき、キャレットのある行に色を付けます。

Type

`boolean`

Default

`true`

`fileEditor.tabWidth`

1 つのタブストップが占める列数です。インデントガイドも同じ間隔を使います。

Type

`integer`

Default

`4`

### `fileExplorer`

右サイドバーのファイルエクスプローラー（ファイルツリー）設定。

`fileExplorer.doubleClickAction`

ファイルエクスプローラーでファイルをダブルクリックした（または検索結果で Return を押した）ときの動作です。\`preview\` は組み込みの cmux ファイルプレビューを開きます（既定かつ従来の動作）。\`defaultEditor\` はそのファイル形式の macOS 既定アプリで開きます。\`preferredEditor\` は \`app.preferredEditor\` コマンドで開き、未設定の場合は既定アプリにフォールバックします。ファイルにのみ適用され、ディレクトリは常に展開・折りたたみされ、非ローカル（リモート）のファイルエクスプローラーは常に cmux プレビューを開きます。

Type

`string`

Default

`"preview"`

Allowed values

`preview, defaultEditor, preferredEditor`

### `shortcuts`

Keyboard shortcut settings from Settings > Keyboard Shortcuts.

`shortcuts.showModifierHoldHints`

Cmd または Control を押し続けている間、ショートカットヒントのチップを表示します。

Type

`boolean`

Default

`true`

`shortcuts.when`

アクションごとの任意のコンテキスト述語（VS Code スタイルの \`when\` 句）です。cmux のアクション ID をキーにします。各値は、コンテキストキーを !、&&、||、括弧で組み合わせた boolean 式です。boolean キー: sidebarFocus、browserFocus、markdownFocus、filePreviewTextEditorFocus、simulatorFocus、terminalFocus、commandPaletteVisible、terminalFindVisible、terminalAlternateScreen、workspaceCanvasLayout。型付きキーは比較できます: 文字列 sidebarMode（files、find、sessions、feed、dock のいずれか）と整数 paneCount、workspaceCount です。比較演算子は ==、!=、=~（正規表現）、<、<=、>、>=、および \`in \[a, b\]\` です。未知または存在しないキーは false として扱われます。 boolean リテラル true および false も使えます。\`key == false\` は \`!key\` と同じです。その句が成立するときだけアクションのショートカットが発火し、他のショートカットとの競合もそのときだけ扱われます。例: { "selectWorkspaceByNumber": "!sidebarFocus" } は、右サイドバーにフォーカスがある場合を除いて Ctrl+1–9 でワークスペースを選択します。{ "selectSurfaceByNumber": "sidebarMode == 'find' && paneCount > 1" } は、ワークスペースに複数のペインがあるときに Find サイドバーへバインドを絞り込みます。

Type

`object`

Default

```
{}
```

### `shortcuts.bindings`

Use a string for a single shortcut, a two-item array for a chord, or `null` to unbind a shortcut in `shortcuts.bindings`. Unbind aliases also include empty string (`""`), `none`, `clear`, `unbound`, and `disabled`. Example chord: `["ctrl+b", "c"]`. Numbered actions use `1` as the stored default and still match digits `1` through `9`.

The defaults below are the same cmux-owned actions listed on the [keyboard shortcuts page](https://cmux.com/ja/docs/keyboard-shortcuts).

#### アプリ

`openSettings`

設定

Default file value

`cmd+,`

`openTeamPicker`

チームピッカーを開く

Default file value

`opt+shift+cmd+t`

`reloadConfiguration`

構成を再読み込み

Default file value

`cmd+shift+,`

`showHideAllWindows`

すべてのcmuxウインドウを表示/非表示システム全体のホットキー

Default file value

`ctrl+opt+cmd+.`

`globalSearch`

グローバル検索cmuxがアクティブな場合

Default file value

`opt+cmd+f`

`commandPalette`

コマンドパレット

Default file value

`cmd+shift+p`

`agentInbox`

エージェント受信トレイを表示

Default file value

`cmd+shift+i`

`commandPaletteNext`

コマンドパレットの次の結果コマンドパレットを開いている間

Default file value

`ctrl+n`

`commandPalettePrevious`

コマンドパレットの前の結果コマンドパレットを開いている間

Default file value

`ctrl+p`

`newWindow`

新規ウインドウ

Default file value

`cmd+shift+n`

`closeWindow`

ウインドウを閉じる

Default file value

`ctrl+cmd+w`

`toggleFullScreen`

フルスクリーンを切り替え

Default file value

`ctrl+cmd+f`

`sendFeedback`

フィードバックを送信デフォルトでは未割り当て

Default file value

`reopenPreviousSession`

前回のセッションを再度開く

Default file value

`cmd+shift+o`

`quit`

cmuxを終了

Default file value

`cmd+q`

#### ワークスペース

`toggleSidebar`

左サイドバーを切り替え

Default file value

`cmd+b`

`toggleFileExplorer`

右サイドバーを切り替え

Default file value

`cmd+opt+b`

`newTab`

新規ローカルワークスペース

Default file value

`cmd+n`

`newLocalWorkspace`

新規ローカルワークスペースリモート tmux ミラーワークスペースがアクティブなときでも、ローカルワークスペースを開きます（通常の新規ワークスペースはそのワークスペースのホスト上でセッションを開始します）

Default file value

`ctrl+opt+cmd+n`

`newBrowserWorkspace`

新規ブラウザワークスペース新規ワークスペースと同様ですが、最初のサーフェスがブラウザペインになり、アドレスバーにフォーカスします

Default file value

`opt+cmd+n`

`newCloudWorkspace`

新規クラウドワークスペース最後に選択した Cloud ワークスペースのマシン、次に右サイドバーで先頭のマシンを使い、利用できるマシンがなければ New Cloud Machine を開きます

Default file value

`cmd+y`

`newCloudMachine`

新規クラウドマシン

Default file value

`shift+cmd+y`

`saveLayoutTemplate`

現在のワークスペースレイアウトをテンプレートとして保存

Default file value

`ctrl+cmd+s`

`openFolder`

フォルダを開く

Default file value

`cmd+o`

`goToWorkspace`

ワークスペースへ移動ワークスペーススイッチャー

Default file value

`cmd+p`

`nextSidebarTab`

次のワークスペース

Default file value

`ctrl+cmd+]`

`prevSidebarTab`

前のワークスペース

Default file value

`ctrl+cmd+[`

`nextSidebarTabInGroup`

グループ内の次のワークスペースデフォルトでは未割り当て。グループのアンカーを除いて循環し、グループに属していない場合はウインドウ全体を循環

Default file value

`prevSidebarTabInGroup`

グループ内の前のワークスペースデフォルトでは未割り当て。グループのアンカーを除いて循環し、グループに属していない場合はウインドウ全体を循環

Default file value

`moveWorkspaceUp`

ワークスペースを上へ移動

Default file value

`ctrl+opt+cmd+[`

`moveWorkspaceDown`

ワークスペースを下へ移動

Default file value

`ctrl+opt+cmd+]`

`focusHistoryBack`

フォーカスを戻すフォーカスを戻す/進めるはブラウザペイン外で Cmd+\[ / Cmd+\] を使い、ブラウザペイン内では同じキーでブラウザの戻る/進むが動作します。ターミナル側で使うには、フォーカスを戻す/進めるの割り当てを解除します。

Default file value

`cmd+[`

`focusHistoryForward`

フォーカスを進めるフォーカスを戻す/進めるはブラウザペイン外で Cmd+\[ / Cmd+\] を使い、ブラウザペイン内では同じキーでブラウザの戻る/進むが動作します。ターミナル側で使うには、フォーカスを戻す/進めるの割り当てを解除します。

Default file value

`cmd+]`

`focusHistoryLast`

直前のフォーカスへ切り替えデフォルトでは未割り当て。現在の位置と直前にフォーカスしていた位置を切り替えるため、2回押すと元の位置に戻ります

Default file value

`selectWorkspaceByNumber`

ワークスペース1…9を選択

Default file value

`cmd+1`

`renameWorkspace`

ワークスペース名を変更

Default file value

`cmd+shift+r`

`editWorkspaceDescription`

ワークスペースの説明を編集

Default file value

`opt+cmd+e`

`markWorkspaceDone`

ワークスペースを完了にする

Default file value

`cmd+;`

`cycleWorkspaceStatus`

ワークスペースのステータスを1つ先へ切り替え

Default file value

`cmd+shift+;`

`toggleChecklistItemComplete`

選択中のチェックリスト項目の完了を切り替えフォーカス中の Todo ペインまたはチェックリストのポップオーバーで有効です。

Default file value

`cmd+enter`

`newWorkspaceGroup`

空のワークスペースグループを作成

Default file value

`ctrl+cmd+g`

`groupSelectedWorkspaces`

選択したワークスペースをグループ化

Default file value

`cmd+shift+g`

`toggleFocusedWorkspaceGroupCollapsed`

フォーカス中のワークスペースグループを折りたたみ/展開

Default file value

`ctrl+cmd+.`

`focusSidebar`

ワークスペースサイドバーにフォーカス↑/↓でワークスペースを選択、ReturnまたはEscでターミナルに戻る

Default file value

`ctrl+cmd+e`

`showWindowHints`

ヒントでクリック：ウィンドウのコントロールにラベルを表示ラベルを入力でクリック、Shift+ラベルで右クリック、Escでキャンセル。プレビュー機能（既定でオフ）：設定 > ベータ機能、またはコマンドパレットで「Click by Hint」をオンにします

Default file value

`cmd+j`

`focusRightSidebar`

右サイドバーのフォーカスを切り替え

Default file value

`cmd+shift+e`

`navigateRightSidebarRows`

フォーカス中のサイドバー行を移動ファイルでは H/L でフォルダを折りたたみ/展開します。検索は / で開始します。

Default file value

`j / k`

`fileExplorerOpenSelection`

選択中のファイルを開く、またはフォルダを切り替えフォーカス中のファイルエクスプローラ

Default file value

`enter`

`fileExplorerOpenSelectionFinderAlias`

選択中のファイルを開く、またはフォルダを切り替えフォーカス中のファイルエクスプローラ向けFinder風エイリアス

Default file value

`cmd+down`

`closeWorkspace`

ワークスペースを閉じる

Default file value

`cmd+shift+w`

`reopenClosedWorkspace`

閉じたワークスペースを再度開くデフォルトでは未割り当て

Default file value

#### サーフェス

`newSurface`

新規サーフェス

Default file value

`cmd+t`

`nextSurface`

次のサーフェス

Default file value

`cmd+shift+]`

`prevSurface`

前のサーフェス

Default file value

`cmd+shift+[`

`moveSurfaceLeft`

サーフェスを左へ並べ替え

Default file value

`opt+cmd+shift+[`

`moveSurfaceRight`

サーフェスを右へ並べ替え

Default file value

`opt+cmd+shift+]`

`moveSurfaceToPreviousPane`

サーフェスを前のペインへ移動

Default file value

`ctrl+cmd+shift+[`

`moveSurfaceToNextPane`

サーフェスを次のペインへ移動

Default file value

`ctrl+cmd+shift+]`

`moveSurfaceToPaneLeft`

サーフェスを左のペインへ移動

Default file value

`opt+cmd+shift+left`

`moveSurfaceToPaneRight`

サーフェスを右のペインへ移動

Default file value

`opt+cmd+shift+right`

`moveSurfaceToPaneUp`

サーフェスを上のペインへ移動

Default file value

`opt+cmd+shift+up`

`moveSurfaceToPaneDown`

サーフェスを下のペインへ移動

Default file value

`opt+cmd+shift+down`

`selectSurfaceByNumber`

サーフェス1…9を選択

Default file value

`ctrl+1`

`renameTab`

タブ名を変更

Default file value

`cmd+r`

`closeTab`

タブを閉じる

Default file value

`cmd+w`

`closeOtherTabsInPane`

ペイン内の他のタブを閉じる

Default file value

`opt+cmd+t`

`reopenClosedBrowserPanel`

最後に閉じた項目を再度開く

Default file value

`cmd+shift+t`

`toggleTerminalCopyMode`

ターミナルコピーモードを切り替え

Default file value

`cmd+shift+m`

`clearScreenKeepScrollback`

画面をクリア（スクロールバックを保持）

Default file value

`cmd+shift+k`

`simulatorHome`

Simulator: ホームフォーカス中のSimulator

Default file value

`cmd+shift+h`

`simulatorRotateLeft`

Simulator: 左に回転フォーカス中のSimulator

Default file value

`cmd+left`

`simulatorRotateRight`

Simulator: 右に回転フォーカス中のSimulator

Default file value

`cmd+right`

`simulatorToggleAppearance`

Simulator: 外観を切り替えフォーカス中のSimulator

Default file value

`cmd+shift+a`

`simulatorToggleSoftwareKeyboard`

Simulator: ソフトウェアキーボードを切り替えフォーカス中のSimulator

Default file value

`cmd+k`

`focusTextBoxInput`

ターミナルとTextBox入力のフォーカスを切り替え

Default file value

`cmd+shift+a`

`cycleTextBoxSubmitAction`

TextBoxの送信アクションを切り替え

Default file value

`shift+tab`

`attachTextBoxFile`

TextBox入力にファイルを添付

Default file value

`opt+cmd+shift+a`

`sendCtrlFToTerminal`

ターミナルにCtrl-Fを送信デフォルトでは未割り当て。フォーカス中のターミナルにCtrl-Fを転送（Claude Code: 2回実行で停止しないバックグラウンドエージェントを強制停止）

Default file value

`sizeTerminalToMyWindow`

共有ターミナルを自分のウィンドウに合わせるターミナルがスマートフォンや他のクライアントと共有されているとき、このMacのウィンドウでグリッドサイズを決めます

Default file value

`ctrl+opt+cmd+=`

`pasteLastScreenshot`

最新のスクリーンショットを貼り付けデフォルトでは未割り当て。macOS のスクリーンショット保存先（変更していなければデスクトップ）にある最新のスクリーンショットのパスをフォーカス中のターミナルに挿入します。リモートワークスペースでは先にアップロードします

Default file value

`saveFilePreview`

ファイルプレビューを保存フォーカス中のテキストプレビュー

Default file value

`cmd+s`

`toggleFileEditorWordWrap`

ファイルエディタの行折り返しを切り替えフォーカス中のファイルエディタ

Default file value

`opt+z`

#### 分割ペイン

`focusLeft`

左のペインにフォーカス

Default file value

`opt+cmd+left`

`focusRight`

右のペインにフォーカス

Default file value

`opt+cmd+right`

`focusUp`

上のペインにフォーカス

Default file value

`opt+cmd+up`

`focusDown`

下のペインにフォーカス

Default file value

`opt+cmd+down`

`focusPreviousPane`

前のペインにフォーカス（循環）デフォルトでは未割り当て。Ghostty の goto\_split:previous のキーバインドでも循環できます（Focus Back が同じキーを使っていない場合）

Default file value

`focusNextPane`

次のペインにフォーカス（循環）デフォルトでは未割り当て。Ghostty の goto\_split:next のキーバインドでも循環できます（Focus Forward が同じキーを使っていない場合）

Default file value

`focusPaneByNumber`

ペイン1…9にフォーカス

Default file value

`ctrl+cmd+1`

`splitRight`

右に分割

Default file value

`cmd+d`

`splitDown`

下に分割

Default file value

`cmd+shift+d`

`newPaneAutoLayout`

新しいペイン（自動レイアウト）Zellij や cmux-tui の Alt-n と同様に全ペインを再配置します。右の列が 4 ペインになると新しい列が開きます

Default file value

`ctrl+cmd+n`

`splitBrowserRight`

右にブラウザ分割

Default file value

`opt+cmd+d`

`splitBrowserDown`

下にブラウザ分割

Default file value

`opt+cmd+shift+d`

`toggleSplitZoom`

ペインズームを切り替え

Default file value

`cmd+shift+enter`

`increaseWorkspaceTerminalFontSize`

選択中のワークスペース内の全ターミナルのフォントサイズを大きくする

Default file value

`ctrl+cmd+=`

`decreaseWorkspaceTerminalFontSize`

選択中のワークスペース内の全ターミナルのフォントサイズを小さくする

Default file value

`ctrl+cmd+-`

`resetWorkspaceTerminalFontSize`

選択中のワークスペース内の全ターミナルのフォントサイズをリセットする

Default file value

`ctrl+cmd+0`

`equalizeSplits`

分割サイズを均等にする

Default file value

`ctrl+cmd+shift+=`

`resize-pane-left`

ペインを左にリサイズ

Default file value

`ctrl+shift+h`

`resize-pane-right`

ペインを右にリサイズ

Default file value

`ctrl+shift+l`

`resize-pane-up`

ペインを上にリサイズ

Default file value

`ctrl+shift+k`

`resize-pane-down`

ペインを下にリサイズ

Default file value

`ctrl+shift+j`

#### キャンバス

`toggleCanvasLayout`

キャンバスレイアウトを切り替え

Default file value

`ctrl+cmd+c`

`canvasRevealFocusedPane`

フォーカス中のペインを表示

Default file value

`ctrl+cmd+r`

`canvasOverview`

全体表示を切り替え

Default file value

`ctrl+cmd+o`

`canvasZoomIn`

拡大

Default file value

`opt+cmd+=`

`canvasZoomOut`

縮小

Default file value

`opt+cmd+-`

`canvasZoomReset`

実寸表示

Default file value

`cmd+0`

`canvasTidy`

ペインをグリッドに整列

Default file value

`ctrl+cmd+t`

#### ブラウザ

`openBrowser`

ブラウザを開く

Default file value

`cmd+shift+l`

`focusBrowserAddressBar`

アドレスバーにフォーカス

Default file value

`cmd+l`

`browserBack`

戻る

Default file value

`cmd+[`

`browserForward`

進む

Default file value

`cmd+]`

`browserReload`

ページを再読み込みフォーカス中のブラウザ

Default file value

`cmd+r`

`browserHardReload`

ページを強制再読み込みフォーカス中のブラウザ

Default file value

`cmd+shift+r`

`browserZoomIn`

拡大

Default file value

`cmd+=`

`browserZoomOut`

縮小

Default file value

`cmd+-`

`browserZoomReset`

実寸表示

Default file value

`cmd+0`

`markdownZoomIn`

Markdownビューア: 拡大フォーカス中のMarkdownビューア

Default file value

`cmd+=`

`markdownZoomOut`

Markdownビューア: 縮小フォーカス中のMarkdownビューア

Default file value

`cmd+-`

`markdownZoomReset`

Markdownビューア: 実寸表示フォーカス中のMarkdownビューア

Default file value

`cmd+0`

`toggleBrowserDeveloperTools`

ブラウザ開発者ツールを切り替え

Default file value

`opt+cmd+i`

`showBrowserJavaScriptConsole`

ブラウザJavaScriptコンソールを表示

Default file value

`opt+cmd+c`

`toggleBrowserFocusMode`

ブラウザフォーカスモードに入るフォーカス中のWebページにショートカットの優先権を渡します。Escを2回押すと終了します。

Default file value

`opt+cmd+enter`

`toggleBrowserDesignMode`

ブラウザデザインモードを切り替えフォーカス中のブラウザで要素を選択して視覚的に編集します

Default file value

`ctrl+opt+cmd+d`

`toggleReactGrab`

React Grabを切り替えフォーカス中のブラウザ、またはターミナルにフォーカスがあるときは唯一のブラウザペイン

Default file value

`cmd+shift+g`

#### 差分ビューア

`openDiffViewer`

差分ビューアを開く

Default file value

`ctrl+cmd+shift+d`

`diffViewerScrollDown`

ビューアを1ステップ下へ滑らかにスクロールフォーカス中の差分またはMarkdownビューア

Default file value

`j`

`diffViewerScrollUp`

ビューアを1ステップ上へ滑らかにスクロールフォーカス中の差分またはMarkdownビューア

Default file value

`k`

`diffViewerScrollHalfPageDown`

ビューアを半ページ下にスクロールフォーカス中の差分またはMarkdownビューア

Default file value

`ctrl+d`

`diffViewerScrollHalfPageUp`

ビューアを半ページ上にスクロールフォーカス中の差分またはMarkdownビューア

Default file value

`ctrl+u`

`diffViewerScrollDownEmacs`

ビューアを1ステップ下へ滑らかにスクロール（Emacs）フォーカス中の差分またはMarkdownビューア

Default file value

`ctrl+n`

`diffViewerScrollUpEmacs`

ビューアを1ステップ上へ滑らかにスクロール（Emacs）フォーカス中の差分またはMarkdownビューア

Default file value

`ctrl+p`

`diffViewerScrollToBottom`

差分の末尾へスクロールフォーカス中の差分ビューア

Default file value

`shift+g`

`diffViewerScrollToTop`

差分の先頭へスクロールフォーカス中の差分ビューア

Default file value

`["g", "g"]`

`diffViewerOpenFileSearch`

差分ファイル検索を開くフォーカス中の差分ビューア

Default file value

`/`

`diffViewerNextFile`

次の差分ファイルへ移動フォーカス中の差分ビューア

Default file value

`["]", "f"]`

`diffViewerPreviousFile`

前の差分ファイルへ移動フォーカス中の差分ビューア

Default file value

`["[", "f"]]`

`diffViewerNextHunk`

次のハンクへ移動フォーカス中の差分ビューア

Default file value

`"n"`

`diffViewerPreviousHunk`

前のハンクへ移動フォーカス中の差分ビューア

Default file value

`"p"`

`diffViewerToggleViewed`

現在のファイルの確認済みを切り替えフォーカス中の差分ビューア

Default file value

`"v"`

#### 検索

`find`

検索

Default file value

`cmd+f`

`findInDirectory`

ディレクトリ内を検索

Default file value

`cmd+shift+f`

`findNext`

次を検索

Default file value

`cmd+g`

`findPrevious`

前を検索

Default file value

`opt+cmd+g`

`hideFind`

検索バーを隠す

Default file value

`opt+cmd+shift+f`

`useSelectionForFind`

選択範囲で検索

Default file value

`cmd+e`

#### 通知

`showNotifications`

通知を表示

Default file value

`cmd+i`

`jumpToUnread`

最新の未読へ移動

Default file value

`cmd+shift+u`

`jumpToLastPrompt`

最後にエージェントへプロンプトを送ったサーフェスへ移動

Default file value

`cmd+shift+b`

`toggleUnread`

現在の項目の未読状態を切り替え

Default file value

`opt+cmd+u`

`markOldestUnreadAndJumpNext`

現在の項目を最古の未読にして次の最新未読へ移動

Default file value

`ctrl+cmd+u`

`markAllNotificationsRead`

すべての通知を既読にするデフォルトでは未割り当て

Default file value

`clearAllNotifications`

すべての通知をクリアデフォルトでは未割り当て

Default file value

`triggerFlash`

フォーカス中のパネルをフラッシュ

Default file value

`cmd+shift+h`

### `shortcuts.when`

アクションごとの任意のコンテキスト述語（VS Code スタイルの when 句）で、cmux のアクション ID をキーにします。バインディングは、その句が成立するときだけ発火し、同じキーストロークの他のバインディングともそのときだけ競合します。句を省略すると、アクションの組み込みコンテキストが維持されます。句で使える語彙:

-   `sidebarFocus`, `browserFocus`, `markdownFocus`, `filePreviewTextEditorFocus`, `simulatorFocus`, `terminalFocus`, `commandPaletteVisible`, `terminalFindVisible`, `terminalAlternateScreen`, `workspaceCanvasLayout` — boolean キー。未知または存在しないキーは false として扱われ、リテラル true / false も使えます。
-   `sidebarMode` (`files`, `find`, `sessions`, `feed`, `dock`), `paneCount`, `workspaceCount` — 比較用の型付きキー。右サイドバーのアクティブモード（文字列）と、ペイン数・ワークスペース数（整数）です。
-   `!`, `&&`, `||`, `(…)`, `==`, `!=`, `=~`, `<`, `<=`, `>`, `>=`, `in [a, b]` — boolean 演算子、型付き比較、正規表現マッチ、リスト所属。比較は && や || より強く結合します。

例えば次の設定では、右サイドバーにフォーカスがある場合を除いて Ctrl+1–9 でワークスペースを選択し（Ctrl+数字 はサイドバーのモード切り替えに残します）、ワークスペースに複数のペインがあるときはサーフェス選択を Find サイドバーに限定します。

```
"shortcuts": {
  "bindings": { "selectWorkspaceByNumber": "ctrl+1" },
  "when": {
    "selectWorkspaceByNumber": "!sidebarFocus",
    "selectSurfaceByNumber": "sidebarMode == 'find' && paneCount > 1"
  }
}
```

Canonical: https://cmux.com/ja/docs/configuration

Documentation index: https://cmux.com/llms.txt