cmux-settings cmux reads user settings from ~/.config/cmux/cmux.json (JSONC). The app installs a file watcher; saving the file applies changes immediately, no restart needed. Legacy ~/.config/cmux/settings.json is read only as a fallback for keys not present in cmux.json . Schema: https://raw.githubusercontent.com/manaflow-ai/cmux/main/web/data/cmux.schema.json . The authoritative path list lives in Sources/CmuxSettingsJSONPathSupport.swift in the cmux checkout, and the installed skill includes a generated copy in references/all-keys.md . Top-level sections are app , terminal , notifications , sidebar , sidebarAppearance , workspaceColors , automation , browser , and shortcuts . Non-settings sections ( actions , ui , commands , vault , rightSidebar ) coexist in the same file. Helper script Use the bundled helper for every read/write. It strips JSONC comments, writes atomically, and validates keys against the schema.

From a cmux checkout

skills/cmux-settings/scripts/cmux-settings < subcommand

From an installed Codex skill

~/.codex/skills/cmux-settings/scripts/cmux-settings < subcommand

For brevity in the rest of this doc, assume the script is on $PATH as cmux-settings . To make it so for a session from a checkout: export PATH="$PWD/skills/cmux-settings/scripts:$PATH" . Show more