用途：cmux 是受 Unix socket CLI 控制的终端复用器，管理窗口、工作区、窗格与表面。AI 智能体用它为并行任务生成隔离终端窗格，发送命令、读取输出并在完成后清理。
主要能力：生成拆分窗格供子智能体或并行工作使用；向指定表面发送命令或按键；读取窗格/表面屏幕内容；创建、列出、关闭、管理工作区；在终端窗格旁打开浏览器表面；编排多窗格布局；重命名、重排或在工区间移动表面/窗格。
核心概念：窗口为顶层系统窗口；工作区为窗口内标签；窗格为区域内矩形拆分块，含一个或多个表面；表面为窗格内实际终端或浏览器实例。引用格式如 pane:5、surface:12、workspace:3，也可用 UUID。
使用方式：命令统一为 cmux [--json] <command> [options]，编程解析输出时务必加 --json。常用命令包括 identify、new-pane --direction right/down、send、send-key、read-screen（可加 --scrollback）、close-surface、list-panes、list-pane-surfaces、focus-pane，以及工作区的 new-workspace、select-workspace、rename-workspace、close-workspace 等。cmux 自动设置 CMUX_WORKSPACE_ID、CMUX_SURFACE_ID、CMUX_TAB_ID、CMUX_SOCKET_PATH 等环境变量，因此在 cmux 内运行时多数命令无需显式指定 ID。
典型流程：先 identify 确认位置，再 new-pane 生成窗格，用 send 发送命令并配合 send-key Enter 执行，然后 read-screen 读取结果，最后 close-surface 清理。并行子智能体可重复此流程并用不同拆分方向形成网格布局。
限制与注意事项：send 不会自动按回车，需另发 Enter；读取可能超屏的长命令输出应加 --scrollback；工作区关闭后旧表面引用失效，发送前宜重新 list-panes；close-surface 关闭的是表面而非窗格，需先关闭其内所有表面使窗格折叠；套嵌环境中 CMUX_SOCKET_PATH 可能未继承，需显式传 --socket-path。相关扩展操作见 pane-management.md、browser-automation.md 与 subagent-workflows.md 参考文件，仅在需要时加载以节省上下文。