Login
manaflow-ai/cmux-skills6 files

Cmux Config

Configure cmux through ~/.config/cmux/cmux.json: settings (appearance, sidebar, notifications, automation, browser, shortcuts, set/get/validate by JSON path), customization (tab bar buttons, plus-button click and right-click menus, custom actions/commands/menus, right sidebar), and sidebar workspace groups (anchor workspaces, group CLI/socket ops, per-cwd group config). Triggers: 'cmux config', 'cmux.json', 'change cmux setting', 'set <x> in cmux', 'rebind a cmux shortcut', 'cmux-customize', 'customize cmux', 'tab bar button', 'add cmux action', 'workspace group', 'group sidebar', 'anchor workspace', 'workspaceGroups'.

Use this skillView repositoryView on skills.sh
Specification
Skill ID
manaflow-ai/cmux-skills/cmux-config
Publisher
manaflow-ai
Repository
cmux-skills
Installs
0
Files
6
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

manaflow-ai/cmux-skills/cmux-configInstalls these files
  • SKILL.md
  • references/all-keys.md
  • references/customize.md
  • references/groups.md
  • references/shortcut-actions.md
  • scripts/cmux-settings

What this skill tells the agent

cmux-config

Single entry point for editing a user's cmux configuration in ~/.config/cmux/cmux.json (JSONC). The app watches the file; saving applies changes immediately, no restart. Legacy ~/.config/cmux/settings.json is read only as a fallback for keys absent from cmux.json.

Three areas, each with a reference:

  • Settings — typed preferences under app, terminal, notifications, sidebar, sidebarAppearance, workspaceColors, automation, browser, shortcuts. See the helper below and references/all-keys.md / references/shortcut-actions.md.
  • Customization — structural config: actions, ui.surfaceTabBar.buttons, ui.newWorkspace (plus-button click + context menu), commands, rightSidebar, vault. See references/customize.md.
  • Workspace groups — collapsible anchor-owned sidebar sections via the cmux workspace group CLI / socket API and workspaceGroups config. See references/groups.md.

Helper script

Use the bundled helper for every settings/customize read and write. It strips JSONC comments, writes atomically, and validates keys against the schema. From the installed skill directory:

./scripts/cmux-settings <subcommand>

For brevity below, assume it is on $PATH as cmux-settings (e.g. export PATH="$HOME/.claude/skills/cmux-config/scripts:$PATH").

CommandWhat it does
cmux-settings pathPrint the config path.
cmux-settings dump [--no-comments]Print the raw file (or parsed JSON).
cmux-settings get <a.b.c>Print value at dotted JSON path.
cmux-settings set <a.b.c> <value>Set value (<value> parsed as JSON; bare words stored as strings).
cmux-settings unset <a.b.c>Delete key, reverting to the in-app default.
cmux-settings list-supportedList every settings JSON path the app recognizes.
cmux-settings validateParse the file and flag unknown settings keys.
cmux-settings openOpen cmux.json in $EDITOR / VS Code / Cursor / TextEdit.

--file <path> overrides the target file (use for the legacy settings.json).

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

Workflow

  1. If the user named a setting in plain English, look it up first: cmux-settings list-supported | rg -i '<keywords>'.
  2. Make the smallest edit (settings/customize via the helper; groups via the cmux workspace group CLI in references/groups.md).
  3. Verify by surface:
  • Typed settings: read back (cmux-settings get <path>) and cmux-settings validate.
  • Customization (actions, ui.*, commands, vault, rightSidebar): read back the exact key (cmux-settings get <path>) and confirm the file still parses (cmux-settings dump --no-comments). Do NOT rely on validate here: it skips structural sections, so a typo like ui.surfaceTabbar.buttons passes validation yet cmux ignores it. Check the key against references/customize.md.
  • Groups: cmux workspace group list (the settings validator does not recognize workspaceGroups).
  1. Tell the user it auto-reloaded on save. No app restart. Revert with cmux-settings unset <key>.

Rules

  • Only edit cmux.json. Never edit settings.json unless asked; it is legacy.
  • Never tell the user to restart cmux to apply a change; the watcher reloads on save.
  • Do not blindly overwrite top-level structural sections (actions, ui, commands, vault, rightSidebar); they hold hand-tuned non-settings config.
  • Color values are #RRGGBB; opacities are 0..1.
  • Shortcut action ids must match the schema enum; look them up in references/shortcut-actions.md before binding.
  • Do not run a tagged app reload for config-only or skill-only changes.
  • For workspace groups prefer CLI/socket operations over editing session JSON, and preserve anchor semantics (see references/groups.md).

More from manaflow-ai

manaflow-ai/cmux-skills

Cmux Artifact

Create durable HTML walkthrough artifacts for cmux dogfood, verification, demos, evidence pages, artifact previews, and open helpful tabs or splits in the current cmux workspace.

manaflow-ai/cmux-skills

Cmux Browser

Automate the browser inside cmux. Use for cmux browser, browser surface, webview, current workspace browser, snapshot refs, DOM actions, waits, screenshots, cookies, storage, tabs, downloads, console, errors, and browser session state.

manaflow-ai/cmux-skills

Cmux CLI

Comprehensive cmux CLI usage guide. Use when the user asks about cmux CLI, cmux --help, socket commands, command discovery, workspaces, panes, surfaces, browser CLI, hooks, feed, settings, or automation through the cmux command.

Use this skill in a project

Open any RiverX project, search the Skills panel for manaflow-ai/cmux-skills/cmux-config, and install it in one click.

Use this skill