用途：查看和编辑 cmux 设置。cmux 从 ~/.config/cmux/cmux.json（JSONC）读取用户设置，文件监听器在保存后自动应用，无需重启；旧版 ~/.config/cmux/settings.json 仅作为回退，在 cmux.json 缺少某键时读取。
主要能力：技能自带助手脚本，读写前会去除 JSONC 注释、用 cmux config validate 校验完整文档，并在不引入校验问题时原子写入。支持 path、dump（--no-comments）、get、set、unset、undo --receipt、list-supported、validate、open 等子命令，并可用 --file 指定文件、--scope global|project 覆盖作用域推断。
使用方式：本地 checkout 用 skills/cmux-settings/scripts/cmux-settings <子命令>，已安装 Codex 技能用 ~/.codex/skills/cmux-settings/scripts/cmux-settings <子命令>。常用流程是先按英文名检索键，例如 cmux-settings list-supported | rg -i 'sidebar.*terminal'，再 set、读回并 validate。示例：cmux-settings set sidebarAppearance.matchTerminalBackground true；cmux-settings set markdown.fontSize 16；cmux-settings set shortcuts.bindings.newTab '["ctrl+b","c"]'。已安装的 cmux CLI 也支持 cmux config get|set|unset|toggle|cycle 和 cmux config preset。
可逆修改：set 可用 --preview 仅预览并给出 revision，再用 --expect-revision 和 --receipt 写入撤销凭据；cmux-settings undo <receipt> 仅在路径仍保持该变更写入的值时恢复。收据文件为 0600 权限，包含配置值，应保持私密。
适用场景：批量或脚本化修改 appearance、sidebar、notifications、browser、editor/viewer、automation、shortcuts 等设置分区，或需先校验再落盘时。
限制：只编辑 cmux.json，除非用户明确要求否则不改 settings.json；不要提示重启 cmux；批量改动后必须 validate；不要盲目覆盖 actions、ui、commands、vault、rightSidebar；快捷键 action id 须匹配 schema 枚举；颜色为 #RRGGBB，不透明度 0..1；路径按每个 . 拆分，键本身含 . 的（如 workspaceGroups.byCwd 中 ~/src/app.web）会被命令拒绝，需直接编辑文件；未在 schema 中出现的键（如 templates.<viewer>）不应自造。set/unset 输出 JSON 结果，拒绝时在 stderr 输出 conflict 并以退出码 1 结束且不写入。完整键列表可用 list-supported 或 references/all-keys.md 查看。