SuperAPI AI 工具集

cmux

部署与运维

查看项目

更新于 10-15 20:31

技能介绍

用途:cmux 是 macOS 原生终端复用应用,可类比为“以原生 macOS 应用形式重想的 tmux”,提供工作区、窗格和实例化管理,并支持通过 CLI 控制。

对象层级:Window(顶层系统窗口)→ Workspace(侧边栏标签,类似 tmux window)→ Pane(分割区域)→ Surface(窗格内的终端或浏览器实例)。对象可用 UUID、短引用(workspace:1、pane:2、surface:3)或数字索引寻址,输出格式由 --id-format refs|uuids|both 控制。

主要能力:工作区命令(new-workspace、list-workspaces、select-workspace、rename-workspace、close-workspace、current-workspace);窗格与输入命令(new-split、new-surface、list-panes、focus-pane、close-surface、send、send-key、read-screen);通知与状态命令(notify、set-status、set-progress、log)。另有浏览器自动化子系统(40+ 命令,含 navigation、click、fill、snapshot、eval、wait 等)、窗口管理、surface 管理、panel/tab 命令、侧边栏元数据、tmux 兼容命令(pipe-pane、wait-for、copy-mode、set-hook、bind-key、popup 等)及诊断命令。

使用方式:CLI 通过 Unix 域套接字 /tmp/cmux.sock 与运行中的应用通信,全局标志包括 --socket、--window、--password、--json、--id-format、--version、--help。示例:cmux new-workspace --command 'echo hello';WS=$(cmux new-workspace | awk '{print $2}');cmux send --workspace "$WS" $'echo hello\n'。cmux 在托管终端内设置 CMUX_WORKSPACE_ID、CMUX_SURFACE_ID、CMUX_TAB_ID、CMUX_SOCKET_PATH。

与 erk 集成:需在 ~/.erk/config.toml 启用 cmux_integration = true,可用 erk config get/set cmux_integration 检查设置;erk exec cmux-open-pr 支持 --pr、--branch、--mode checkout|teleport;启用后 erk dash TUI 命令面板提供 cmux checkout 及复制命令。

限制与注意事项:--command 会自动追加换行,不要自行添加 \n;send 不会自动追加换行,必须显式包含 \n;new-workspace 返回 OK <uuid>;--command 中防止 $() 提前展开应使用单引号;CLI 无 --working-directory 标志,可用 cd 替代;工作区创建后存在约 0.5 秒启动延迟;工作区名称仅作标签,cmux 不感知 git 分支。资料未提供收费、价格及平台支持范围的更多细节。