cmux 是 macOS 原生终端应用，用于并行运行多个 AI 编程智能体。它提供 CLI（cmux）和 Unix 套接字 JSON-RPC API（/tmp/cmux.sock），可完成拓扑管理与浏览器控制。核心概念：窗口（Window）、工作区（Workspace）、窗格（Pane）、表面（Surface，终端或浏览器标签）。
主要能力：查询与创建拓扑（cmux identify --json、cmux tree、list-workspaces、list-panes、list-surfaces、new-workspace、new-pane、move-surface、split-off、close-surface）；向表面发送输入（cmux send --surface surface:7、cmux send-key --surface surface:7 enter）；通知与侧栏元数据（notify、set-status、set-progress、log、sidebar-state）；浏览器自动化（open、wait、snapshot、click、fill、goto、get、eval、cookies、state、console、errors、screenshot）；Markdown 查看器（markdown open）。
用法要点：引用必须带前缀（如 pane:38、surface:46），裸数字会被当作索引；read-screen 与 capture-pane 没有 --pane，需先用 list-pane-surfaces 解析为表面；不要追加 2>/dev/null，以免掩盖错误。可通过 CMUX_SOCKET_PATH、CMUX_WORKSPACE_ID、CMUX_SURFACE_ID、CMUX_PORT 检测与定位。安装：brew tap manaflow-ai/cmux && brew install --cask cmux，并可用 sudo ln -sf 建立命令行链接、cmux hooks setup 配置智能体钩子。
限制：仅支持 macOS；WKWebView 不支持视口/地理/离线模拟、trace 录制、网络拦截与原始输入注入；套接字默认 cmuxOnly 模式，外部进程可能连接失败；恢复会话会剥离敏感环境变量；技能文件需重启消费方智能体生效；旧版 v1 套接字载荷被拒绝。自动化应保持非侵入：锚定 CMUX_WORKSPACE_ID、避免推测性改变焦点、必要时传 --focus false。资料中的 references/socket-api.md 为外部依赖，未随附，需自行从上游获取并核验。其余细节以 cmux <cmd> --help 为准。