用途：管理 cmux 侧边栏中的可折叠命名工作区分组。每个分组由锚点工作区拥有，分组标题即锚点的侧边栏呈现，锚点没有独立行；关闭锚点会解散分组，其余成员保留为未分组工作区。
主要能力：CLI 提供 list、create、ungroup、delete、rename、collapse、expand、pin、unpin、add、remove、set-anchor、new-workspace、set-color、set-icon、move、focus 等操作，均支持 --json；cmux workspace-group 为兼容别名，group-id 可用 UUID 或 workspace_group:1 之类引用。create 会新建锚点工作区，不会把已有工作区提升为锚点，--from 指定成为子成员的工作区。ungroup 解散分组但保留全部成员；delete 具破坏性，会关闭组内所有工作区。new-workspace 在锚点 cwd 创建新工作区并加入分组。
使用方式：CLI 是 v2 JSON socket API 的薄封装，可直接调用 workspace.group.list、create、ungroup、delete、rename、collapse、expand、pin、unpin、add、remove、set_anchor、new_workspace、set_color、set_icon、move、focus 等方法，均接受 window_id / window_ref 以指定非焦点窗口。配置位于 ~/.config/cmux/cmux.json，按锚点 cwd 键控，支持 * 与 ? 的 fnmatch 通配及 ~ 展开，最长匹配优先；可设置 color、icon、newWorkspacePlacement、contextMenu。newWorkspacePlacement 取值 afterCurrent、top、end，解析顺序为显式参数、按 cwd 配置、全局配置、内置默认 afterCurrent。默认快捷键 Cmd-Shift-G 对侧边栏选中工作区分组，可在设置中改绑。
限制与规则：优先使用 CLI 或 socket 操作，不要直接编辑会话 JSON；不要写入不支持的未来配置键，不确定时查阅 cmux 的 web/data/cmux.schema.json；脚本中需保留锚点语义，移动分组即移动锚点区段。分组与成员关系通过 SessionPersistenceStore 持久化到 ~/Library/Application Support/cmux/session-<bundle-id>.json，采用原子重命名写入，无 WAL。