#설정

cmux는 Ghostty 설정 파일에서 구성을 읽어오므로, Ghostty에서 이전하는 경우 익숙한 옵션을 사용할 수 있습니다.

#설정 파일 위치

cmux는 다음 위치에서 설정을 순서대로 찾습니다:

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

~/.config/cmux/cmux.json
.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}",
  //   "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": {
  //   // Default body font size (points) for newly opened markdown viewers.
  //   // Zoom a viewer live with Cmd-+ / Cmd-- / Cmd-0.
  //   "fontSize": 15,
  //   // Default body font family. Empty keeps the system markdown font stack.
  //   "fontFamily": "",
  //   // Default maximum reading column width, in CSS pixels.
  //   "maxWidth": 980
  // },

  // "fileEditor": {
  //   // Wrap long lines at the editor's right edge instead of scrolling horizontally.
  //   "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"
  // },

  // "shortcuts": {
  //   "bindings": {
  //     "toggleSidebar": "cmd+b",
  //     "toggleFileExplorer": "cmd+opt+b",
  //     "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.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.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.forkConversationDefaultDestination

탭 컨텍스트 메뉴의 기본 Fork Conversation 동작에 사용할 기본 대상입니다. 하위 메뉴에는 여전히 모든 대상이 표시됩니다.

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 leave the working directory unset so Ghostty's working-directory setting can provide the default.

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: true

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.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.reorderOnNotification

Move workspaces with new notifications toward the top.

Type: boolean
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.warnBeforeClosingTabXButton

탭 닫기 버튼으로 탭을 닫기 전에 확인을 표시합니다.

Type: boolean
Default: false

app.hideTabCloseButton

창 영역 탭 막대에서 탭 닫기 버튼을 숨깁니다.

Type: boolean
Default: false

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.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.copyOnSelect

선택이 확정되면 더블 클릭 및 트리플 클릭으로 선택한 단어와 줄을 포함해 선택한 터미널 텍스트를 시스템 클립보드에 복사합니다.

Type: boolean
Default: false

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

Opt-in Agent Hibernation settings. cmux kills idle background agent processes to free RAM and CPU, then resumes them with their saved session when their tab is visited. A terminal is only suspended when it runs a restorable coding agent, the agent lifecycle reports idle, the terminal is off-screen, the live-terminal limit is exceeded, and its output has stayed unchanged for the idle window plus a short confirmation settle window. The placeholder Resume button is a manual fallback.

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.textBoxMaxLines

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

Type: integer
Default: 10

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: []

#`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.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.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.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.branchLayout

Show git branch details stacked vertically or inline.

Type: string
Default: "vertical"
Allowed values: vertical, inline

sidebar.showNotificationMessage

Show the latest notification text in the sidebar.

Type: boolean
Default: true

sidebar.showBranchDirectory

Show the workspace working directory.

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.showCustomMetadata

Show custom metadata pills.

Type: boolean
Default: true

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, 그룹 헤더의 + 버튼, 구성된 그룹 액션이 새 workspace를 배치할 위치의 전역 기본값입니다: `afterCurrent` (활성 그룹 내 workspace 바로 뒤, 없으면 top), `top` (앵커 바로 뒤의 두 번째 위치), `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.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: false

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.03

#`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.claudeBinaryPath

Custom path to the claude binary.

Type: string
Default: ""

automation.workspaceAutoNaming

에이전트 대화 내용을 기반으로 워크스페이스와 탭의 이름을 자동으로 지정하는 선택적 AI 기능입니다. 활성화하면 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.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

#`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.discardHiddenWebViews

Allow hidden browser tabs to release page memory and restore when shown again.

Type: boolean
Default: true

browser.hiddenWebViewDiscardDelaySeconds

Seconds a browser tab must stay hidden before cmux frees its page memory.

Type: number
Default: 300

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

Default body font size, in points, for newly opened markdown viewers. Zoom a viewer live with Cmd-+ / Cmd-- / Cmd-0.

Type: integer
Default: 15

markdown.fontFamily

Default body font family for newly opened markdown viewers. Leave empty for the system markdown font stack.

Type: string
Default: ""

markdown.maxWidth

Default maximum reading column width, in CSS pixels, for newly opened markdown viewers.

Type: integer
Default: 980

#`fileEditor`

Built-in plain-text file editor settings.

fileEditor.wordWrap

Wrap long lines at the editor's right edge instead of scrolling horizontally.

Type: boolean
Default: false

#`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를 키로 사용합니다. 각 값은 컨텍스트 키를 !, &&, || 및 괄호로 조합한 불리언 표현식입니다. 불리언 키: sidebarFocus, browserFocus, markdownFocus, terminalFocus, commandPaletteVisible, terminalFindVisible. 타입이 있는 키는 비교를 지원합니다: 문자열 sidebarMode(files, find, sessions, feed, dock 중 하나)와 정수 paneCount, workspaceCount입니다. 비교 연산자는 ==, !=, =~(정규식), <, <=, >, >=, `in [a, b]`이며, 알 수 없거나 존재하지 않는 키는 false로 평가됩니다. 불리언 리터럴 true와 false도 사용할 수 있으며, `key == false`는 `!key`와 같습니다. 액션의 단축키는 이 절이 참일 때만 실행되며, 다른 단축키와의 충돌도 그때만 발생합니다. 예: { "selectWorkspaceByNumber": "!sidebarFocus" }는 오른쪽 사이드바에 포커스가 있을 때를 제외한 모든 곳에서 Ctrl+1–9로 워크스페이스를 선택합니다. { "selectSurfaceByNumber": "sidebarMode == 'find' && paneCount > 1" }는 워크스페이스에 패널이 여러 개 있을 때 바인딩을 찾기 사이드바로 한정합니다.

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.

App

openSettings

Settings

Default file value

cmd+,

reloadConfiguration

Reload configuration

Default file value

cmd+shift+,

showHideAllWindows

Show/hide all cmux windowssystem-wide hotkey

Default file value

ctrl+opt+cmd+.

globalSearch

Global searchsystem-wide hotkey

Default file value

opt+cmd+f

commandPalette

Command palette

Default file value

cmd+shift+p

commandPaletteNext

Command palette next resultwhen the command palette is open

Default file value

ctrl+n

commandPalettePrevious

Command palette previous resultwhen the command palette is open

Default file value

ctrl+p

newWindow

New window

Default file value

cmd+shift+n

closeWindow

Close window

Default file value

ctrl+cmd+w

toggleFullScreen

Toggle full screen

Default file value

ctrl+cmd+f

sendFeedback

Send feedbackunbound by default

Default file value

reopenPreviousSession

Reopen previous session

Default file value

cmd+shift+o

quit

Quit cmux

Default file value

cmd+q

워크스페이스

toggleSidebar

Toggle left sidebar

Default file value

cmd+b

toggleFileExplorer

Toggle right sidebar

Default file value

cmd+opt+b

newTab

New workspace

Default file value

cmd+n

newBrowserWorkspace

New browser workspacelike New Workspace, but the first surface is a browser pane with the address bar focused

Default file value

opt+cmd+n

openFolder

Open folder

Default file value

cmd+o

goToWorkspace

Go to workspaceworkspace switcher

Default file value

cmd+p

nextSidebarTab

Next workspace

Default file value

ctrl+cmd+]

prevSidebarTab

Previous workspace

Default file value

ctrl+cmd+[

focusHistoryBack

Focus backcmux uses Cmd+[ and Cmd+] for focus history by default. Unbind Focus Back/Forward in Settings to let browser or terminal shortcuts handle those keys.

Default file value

cmd+[

focusHistoryForward

Focus forwardcmux uses Cmd+[ and Cmd+] for focus history by default. Unbind Focus Back/Forward in Settings to let browser or terminal shortcuts handle those keys.

Default file value

cmd+]

selectWorkspaceByNumber

Select workspace 1…9

Default file value

cmd+1

renameWorkspace

Rename workspace

Default file value

cmd+shift+r

editWorkspaceDescription

Edit workspace description

Default file value

opt+cmd+e

focusRightSidebar

Toggle right-sidebar focus

Default file value

cmd+shift+e

navigateRightSidebarRows

Navigate focused sidebar rowsIn Files, H/L collapse and expand folders. Search starts with /.

Default file value

j / k

closeWorkspace

Close workspace

Default file value

cmd+shift+w

서피스

newSurface

New surface

Default file value

cmd+t

nextSurface

Next surface

Default file value

cmd+shift+]

prevSurface

Previous surface

Default file value

cmd+shift+[

selectSurfaceByNumber

Select surface 1…9

Default file value

ctrl+1

renameTab

Rename tab

Default file value

cmd+r

closeTab

Close tab

Default file value

cmd+w

closeOtherTabsInPane

Close other tabs in pane

Default file value

opt+cmd+t

reopenClosedBrowserPanel

Reopen last closed

Default file value

cmd+shift+t

toggleTerminalCopyMode

Toggle terminal copy mode

Default file value

cmd+shift+m

clearScreenKeepScrollback

Clear screen (keep scrollback)

Default file value

cmd+shift+k

focusTextBoxInput

Switch focus between terminal and TextBox input

Default file value

cmd+shift+a

attachTextBoxFile

Attach file to TextBox input

Default file value

opt+cmd+shift+a

sendCtrlFToTerminal

Send Ctrl-F to terminalunbound by default; forwards Ctrl-F to the focused terminal (Claude Code: invoke twice to force-stop hung background agents)

Default file value

saveFilePreview

Save file previewfocused text preview

Default file value

cmd+s

분할 패널

focusLeft

Focus pane left

Default file value

opt+cmd+left

focusRight

Focus pane right

Default file value

opt+cmd+right

focusUp

Focus pane up

Default file value

opt+cmd+up

focusDown

Focus pane down

Default file value

opt+cmd+down

splitRight

Split right

Default file value

cmd+d

splitDown

Split down

Default file value

cmd+shift+d

splitBrowserRight

Split browser right

Default file value

opt+cmd+d

splitBrowserDown

Split browser down

Default file value

opt+cmd+shift+d

toggleSplitZoom

Toggle pane zoom

Default file value

cmd+shift+enter

equalizeSplits

Equalize split sizes

Default file value

ctrl+cmd+=

캔버스

toggleCanvasLayout

Toggle canvas layout

Default file value

ctrl+cmd+c

canvasRevealFocusedPane

Reveal focused pane

Default file value

ctrl+cmd+r

canvasOverview

Toggle overview zoom

Default file value

ctrl+cmd+o

canvasZoomIn

Zoom in

Default file value

opt+cmd+=

canvasZoomOut

Zoom out

Default file value

opt+cmd+-

canvasZoomReset

Actual size

Default file value

opt+cmd+0

canvasTidy

Tidy panes into a grid

Default file value

ctrl+cmd+t

브라우저

openBrowser

Open browser

Default file value

cmd+shift+l

focusBrowserAddressBar

Focus address bar

Default file value

cmd+l

browserBack

Back

Default file value

cmd+[

browserForward

Forward

Default file value

cmd+]

browserReload

Reload pagefocused browser

Default file value

cmd+r

browserHardReload

페이지 강력 새로고침포커스된 브라우저

Default file value

cmd+shift+r

browserZoomIn

Zoom in

Default file value

cmd+=

browserZoomOut

Zoom out

Default file value

cmd+-

browserZoomReset

Actual size

Default file value

cmd+0

markdownZoomIn

Markdown viewer: zoom infocused markdown viewer

Default file value

cmd+=

markdownZoomOut

Markdown viewer: zoom outfocused markdown viewer

Default file value

cmd+-

markdownZoomReset

Markdown viewer: actual sizefocused markdown viewer

Default file value

cmd+0

toggleBrowserDeveloperTools

Toggle browser developer tools

Default file value

opt+cmd+i

showBrowserJavaScriptConsole

Show browser JavaScript console

Default file value

opt+cmd+c

toggleBrowserFocusMode

Enter browser focus modeGives the focused web page first claim on shortcuts. Press Esc twice to exit.

Default file value

opt+cmd+enter

toggleReactGrab

Toggle React Grabfocused browser, or the only browser pane when a terminal is focused

Default file value

cmd+shift+g

Diff 뷰어

openDiffViewer

Open diff viewer

Default file value

ctrl+cmd+shift+d

diffViewerScrollDown

Scroll diff downfocused diff viewer

Default file value

j

diffViewerScrollUp

Scroll diff upfocused diff viewer

Default file value

k

diffViewerScrollToBottom

Scroll diff to bottomfocused diff viewer

Default file value

shift+g

diffViewerScrollToTop

Scroll diff to topfocused diff viewer

Default file value

["g", "g"]

diffViewerOpenFileSearch

Open diff file searchfocused diff viewer

Default file value

/

찾기

find

Find

Default file value

cmd+f

findInDirectory

Find in directory

Default file value

cmd+shift+f

findNext

Find next

Default file value

cmd+g

findPrevious

Find previous

Default file value

opt+cmd+g

hideFind

Hide find bar

Default file value

opt+cmd+shift+f

useSelectionForFind

Use selection for find

Default file value

cmd+e

알림

showNotifications

Show notifications

Default file value

cmd+i

jumpToUnread

Jump to latest unread

Default file value

cmd+shift+u

toggleUnread

Toggle current item unread state

Default file value

opt+cmd+u

markOldestUnreadAndJumpNext

Mark current item as oldest unread and jump to the next latest unread

Default file value

ctrl+cmd+u

triggerFlash

Flash focused panel

Default file value

cmd+shift+h

#`shortcuts.when`

액션별 선택적 컨텍스트 조건자(VS Code 스타일 when 절)이며 cmux 액션 ID를 키로 사용합니다. 바인딩은 해당 절이 참일 때만 실행되고, 같은 키 입력의 다른 바인딩과도 그때만 충돌합니다. 절을 생략하면 액션의 기본 컨텍스트가 유지됩니다. 절에서 사용할 수 있는 어휘:

sidebarFocus, browserFocus, markdownFocus, terminalFocus, commandPaletteVisible, terminalFindVisible — 불리언 키. 알 수 없거나 존재하지 않는 키는 false로 평가되며, 리터럴 true와 false도 사용할 수 있습니다.
sidebarMode (files, find, sessions, feed, dock), paneCount, workspaceCount — 비교용 타입 키: 오른쪽 사이드바의 활성 모드(문자열)와 패널 및 워크스페이스 개수(정수)입니다.
!, &&, ||, (…), ==, !=, =~, <, <=, >, >=, in [a, b] — 불리언 연산자, 타입 비교, 정규식 일치, 리스트 포함 여부. 비교는 &&와 ||보다 더 강하게 결합합니다.

예를 들어 다음 설정은 오른쪽 사이드바에 포커스가 있을 때를 제외한 모든 곳에서 Ctrl+1–9로 워크스페이스를 선택하게 하고(Ctrl+1–5는 사이드바 모드 전환기에 남겨 둠), 워크스페이스에 패널이 여러 개 있을 때 서피스 선택을 찾기 사이드바로 한정합니다:

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

#설정

#설정 파일 위치

#예시 설정

#cmux.json

#Schema reference

#Metadata

#app

#terminal

#notifications

#sidebar

#workspaceGroups

#workspaceColors

#sidebarAppearance

#automation

#browser

#markdown

#fileEditor

#fileExplorer

#shortcuts

#shortcuts.bindings

App

워크스페이스

서피스

분할 패널

캔버스

브라우저

Diff 뷰어

찾기

알림

#shortcuts.when

#`app`

#`terminal`

#`notifications`

#`sidebar`

#`workspaceGroups`

#`workspaceColors`

#`sidebarAppearance`

#`automation`

#`browser`

#`markdown`

#`fileEditor`

#`fileExplorer`

#`shortcuts`

#`shortcuts.bindings`

#`shortcuts.when`