cmuxcmux
/docs
カスタマイズと管理設定
カスタマイズと管理

設定

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 and the source lives at 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.

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.

アプリ

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"
  }
}