用途：查看和编辑 cmux 的用户设置。cmux 从 ~/.config/cmux/cmux.json（JSONC 格式）读取设置，应用内置文件监听器，保存即生效，无需重启。旧版 ~/.config/cmux/settings.json 仅作为 cmux.json 中缺失键的回退读取。
主要能力：通过配套脚本 cmux-settings 进行读写，脚本会去除 JSONC 注释、原子写入并按 schema 校验键。子命令包括 path（打印配置路径）、dump（打印原始文件，保留注释；加 --no-comments 打印解析后 JSON）、get <a.b.c>（按点路径读取）、set <a.b.c> <value>（写入，值按 JSON 解析，无引号纯文本存为字符串）、unset <a.b.c>（删除键，恢复应用默认）、list-supported（列出所有可识别设置路径）、validate（解析并标记未知键）、open（用编辑器打开）。--file <path> 可覆盖目标文件。
使用方式：先确认改动，用 list-supported 查找设置路径，再 set 写入，最后 get 读回并 validate 校验。例如：cmux-settings set app.appearance dark；cmux-settings set sidebarAppearance.matchTerminalBackground true；cmux-settings set shortcuts.bindings.toggleSidebar cmd+b。设置分区包括 app、terminal、notifications、sidebar、sidebarAppearance、workspaceColors、automation、browser、shortcuts。
限制：只编辑 cmux.json，除非用户明确要求否则不要改 settings.json；不要告知用户重启 cmux；批量编辑后必须 validate；不要盲目覆盖 actions、ui、commands、vault、rightSidebar 等非设置分区；快捷键 action id 须匹配 schema 枚举；颜色须为 #RRGGBB，不透明度为 0..1。完整默认值与说明可运行 list-supported 或查阅 references/all-keys.md。