Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →View and edit cmux settings in ~/.config/cmux/cmux.json. Use when the user wants to change cmux preferences (appearance, sidebar, notifications, automation, browser, shortcuts), set a value by JSON path, validate the file, open it in an editor, or look up which keys cmux recognizes. Triggers on '/cmux-settings', 'change cmux setting', 'set <something> in cmux', 'cmux config', 'cmux.json', or 'rebind a cmux shortcut'.
.claude/skills/manaflow-ai-cmux-settings/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-04 | ✗→✓ | ▲ Improved | 38% | 0% |
| case-05 | ✗→✓ | ▲ Improved | 89% | 0% |
| case-06 | ✗→✓ | ▲ Improved | 40% | 0% |
| case-07 | ✗→✓ | ▲ Improved | 0% | 0% |
| case-08 | ✗→✓ | ▲ Improved | 4% | 0% |
cmux reads user settings from ~/.config/cmux/cmux.json (JSONC). A file watcher applies changes on save, no restart. Legacy ~/.config/cmux/settings.json is read only as a fallback for keys absent from cmux.json.
Schema: https://raw.githubusercontent.com/manaflow-ai/cmux/main/web/data/cmux.schema.json. The helper uses the schema-generated path list in references/all-keys.md in both checkouts and installed skills. If that reference is unavailable, it falls back to paths discoverable in Sources/CmuxSettingsJSONPathSupport.swift. Settings sections are app, terminal, notifications, sidebar, sidebarAppearance, workspaceColors, automation, browser, shortcuts. Non-settings sections (actions, ui, commands, vault, rightSidebar) share the same file.
Use the bundled helper for every read/write. It strips JSONC comments, validates the complete proposed document with cmux config validate before writing, and writes atomically only after semantic validation passes.
bashskills/cmux-settings/scripts/cmux-settings <subcommand> # from a cmux checkout ~/.codex/skills/cmux-settings/scripts/cmux-settings <subcommand> # installed Codex skill
The rest of this doc assumes it is on $PATH as cmux-settings; from a checkout, export PATH="$PWD/skills/cmux-settings/scripts:$PATH".
| Command | What it does | |---|---| | cmux-settings path | Print the config path. | | cmux-settings dump | Print the raw file (preserves comments). | | cmux-settings dump --no-comments | Print the parsed JSON. | | cmux-settings get <a.b.c> | Print value at dotted JSON path. | | cmux-settings set <a.b.c> <value> | Set value. <value> is parsed as JSON (true, 42, "text", […], {…}); unquoted plain words are stored as strings. | | cmux-settings unset <a.b.c> | Delete key, reverting to the in-app default. | | cmux-settings list-supported | List every settings JSON path the app recognizes. | | cmux-settings validate | Run the same semantic validation as cmux config validate (unknown paths, types, enums, bounds, nested constraints, and config scope). | | cmux-settings open | Open cmux.json in $EDITOR, VS Code, Cursor, or TextEdit. |
--file <path> overrides the target file. Scope is inferred from the real global paths and the project config discovered from the current directory; use --scope global|project to override that inference for an arbitrary file.
bash cmux-settings list-supported | rg -i 'sidebar.*terminal|terminal.*sidebar'
bash cmux-settings set sidebarAppearance.matchTerminalBackground true cmux-settings set app.appearance dark cmux-settings set shortcuts.bindings.newTab '["ctrl+b","c"]' cmux-settings set browser.hostsToOpenInEmbeddedBrowser '["localhost","*.internal.example"]'
cmux-settings validate.cmux-settings unset <key> reverts it.app.appearance ("system" | "light" | "dark"), app.appIcon, app.menuBarOnly, app.minimalMode.sidebarAppearance.matchTerminalBackground, .tintColor, .tintOpacity (0..1).sidebar.hideAllDetails, .showBranchDirectory, .showPullRequests, .showPorts, .showLog.notifications.dockBadge, .sound (enum including "none", "custom_file"), .customSoundFilePath, .hooks (array).browser.defaultSearchEngine, .theme, .defaultZoomLevel, .openTerminalLinksInCmuxBrowser, .hostsToOpenInEmbeddedBrowser.automation.socketControlMode (off | cmuxOnly | automation | password | allowAll), .portBase, .portRange.shortcuts.bindings.<actionId> = "cmd+b", ["ctrl+b","c"], null, or "" to unbind. Action ids in references/shortcut-actions.md.Full list of settings, defaults, and descriptions: cmux-settings list-supported or references/all-keys.md.
cmux.json. Never settings.json unless the user explicitly asks; it is legacy and read only when a key is absent from cmux.json.cmux-settings validate after a bulk edit. Validation errors include the exact config path and violated constraint.actions, ui, commands, vault, or rightSidebar; they share the file and hold hand-tuned non-settings config.#RRGGBB; opacities are 0..1.web/app/[locale]/(landing)/docs/configuration/page.tsx mirrors the schema 1:1.| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-01 | fail→fail | 10,100 | 7,750 | -23% | 1 | 1 | 0% | 1,309 | 1,813 | +39% | 0 | 0 | — |
case-02 | fail→fail | 10,557 | 7,499 | -29% | 1 | 1 | 0% | 1,589 | 1,612 | +1% | 0 | 0 | — |
case-03 | fail→fail | 33,463 | 6,887 | -79% | 1 | 1 | 0% | 1,632 | 1,596 | -2% | 0 | 0 | — |
case-04 | fail→pass | 13,110 | 13,719 | +5% | 1 | 1 | 0% | 1,524 | 2,098 | +38% | 0 | 0 | — |
case-05 | fail→pass | 8,986 | 12,934 | +44% | 1 | 1 | 0% | 1,475 | 2,790 | +89% | 0 | 0 | — |
case-06 | fail→pass | 20,884 | 29,571 | +42% | 1 | 1 | 0% | 1,920 | 2,685 | +40% | 0 | 0 | — |
case-07 | fail→pass | 10,949 | 2,620 | -76% | 1 | 1 | 0% | 1,668 | 1,674 | +0% | 0 | 0 | — |
case-08 | fail→pass | 16,552 | 5,209 | -69% | 1 | 1 | 0% | 2,090 | 2,169 | +4% | 0 | 0 | — |
case-09 | fail→pass | 39,858 | 13,972 | -65% | 1 | 1 | 0% | 2,279 | 1,992 | -13% | 0 | 0 | — |
case-10 | fail→pass | 11,303 | 7,384 | -35% | 1 | 1 | 0% | 1,928 | 2,355 | +22% | 0 | 0 | — |
case-11 | fail→pass | 18,693 | 7,610 | -59% | 1 | 1 | 0% | 2,176 | 2,553 | +17% | 0 | 0 | — |
case-12 | fail→pass | 17,551 | 3,220 | -82% | 1 | 1 | 0% | 1,510 | 1,683 | +11% | 0 | 0 | — |
case-13 | fail→pass | 13,660 | 6,379 | -53% | 1 | 1 | 0% | 2,016 | 2,217 | +10% | 0 | 0 | — |
case-14 | fail→pass | 16,045 | 7,122 | -56% | 1 | 1 | 0% | 2,371 | 2,389 | +1% | 0 | 0 | — |
case-15 | fail→pass | 57,711 | 3,809 | -93% | 1 | 1 | 0% | 2,395 | 1,877 | -22% | 0 | 0 | — |
case-16 | fail→pass | 14,899 | 9,264 | -38% | 1 | 1 | 0% | 1,605 | 1,841 | +15% | 0 | 0 | — |
case-17 | fail→pass | 10,747 | 3,581 | -67% | 1 | 1 | 0% | 1,704 | 1,807 | +6% | 0 | 0 | — |
case-18 | fail→pass | 9,380 | 3,840 | -59% | 1 | 1 | 0% | 1,598 | 1,908 | +19% | 0 | 0 | — |
case-19 | fail→pass | 28,579 | 3,659 | -87% | 1 | 1 | 0% | 2,664 | 1,796 | -33% | 0 | 0 | — |
case-20 | pass→pass | 9,386 | 13,860 | +48% | 1 | 1 | 0% | 1,415 | 2,287 | +62% | 0 | 0 | — |
case-21 | pass→pass | 6,849 | 5,378 | -21% | 1 | 1 | 0% | 888 | 2,109 | +138% | 0 | 0 | — |
case-22 | pass→fail | 29,688 | 10,021 | -66% | 1 | 1 | 0% | 2,545 | 1,626 | -36% | 0 | 0 | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 22 cases were attempted, and 18 counted toward the lift figure. The other 4 produced results that are not comparable between the two arms, so they are excluded from the headline rather than averaged into it. The headline lift of +68 percentage points is the difference between those two pass rates over the 18 comparable cases. 2 cases got worse with the skill loaded, and they are included in that figure.
Without the skill loaded, the model failed this case. With it loaded, the same prompt on the same model passed. This is one improved case from the latest verified run; every case, including any that regressed, is in the table above.
| Model | Method | Date | Lift |
|---|---|---|---|
| gemini-3.6-flash | verified | 8/17/2026 | +32% |
| gemini-3.6-flash | verified | 8/4/2026 | +59% |
Other measured skills in the registry, with their headline benchmark lift.