cmux 是一款面向 AI 编码智能体的终端复用器,通过可编程 socket API 提供终端分屏管理、无头浏览器自动化和智能体团队协作,均以 CLI 命令驱动。
用途与主要能力: 一、终端分屏:用 new-split right(左右并排)或 new-split down(上下堆叠)创建窗格,通过 --surface 定向发送命令、捕获输出(capture-pane,可加 --scrollback 取历史)、发送按键(send-key-surface)和管理窗格(focus/close/swap/move/reorder)。 二、浏览器自动化:内置完整无头 Chromium,无需外部 Chrome。采用基于快照的元素引用(e1、e2…)而非 CSS 选择器;支持 goto、snapshot --interactive、click、fill、type、press、check、select、scroll、wait(加载状态/选择器/文本/URL/函数)、get(text/html/value/attr/count/box/styles)、find 定位器、eval JS、frame 与 dialog 处理、cookies 与 storage 管理、state save/load 保存恢复登录态、console/errors 诊断、screenshot 截图及脚本样式注入。 三、状态与通知:set-status 设置侧边栏状态图标与颜色,set-progress 显示进度条,log 记录消息,notify 发送系统通知。 四、智能体团队协作:为每个子智能体分配可见分屏,通过 Agent 工具传递 surface 引用,用 SendMessage 与任务列表协调,而非互读终端输出。
必要用法:先运行 cmux identify --json 确认当前上下文;自动注入 $CMUX_SURFACE_ID、$CMUX_WORKSPACE_ID;句柄使用短引用 surface:N、pane:N、workspace:N、window:N。黄金规则是不要抢焦点,始终使用 --surface 定向。DOM 变化后元素引用会失效,导航或点击后需重新 snapshot,可用 --snapshot-after 自动刷新。
典型场景:后台构建并读取日志、QA 浏览器测试流程、状态驱动的长任务、混合布局(终端加浏览器)。
限制:资料未说明安装方式、收费、价格或平台支持;建议不要在分屏中运行 claude -p,应使用 Agent 工具配合 team_name。