这个 Skill 能做什么,适合哪些场景?
cmux-cua 是 cmux 应用内置的一项技能,为每个代理会话(Claude Code、Codex)挂载一个名为 cmux-cua 的 MCP 工具服务器。代理因此可以读取辅助功能树、截图并点击、输入、滚动、拖拽真实 macOS 应用。所有操作都在本地通过独立的 cmux Computer Use 辅助程序完成,权限(辅助功能与屏幕录制)授予该辅助程序而非主应用。该技能明确禁止未经用户直接请求的自动调用。
- 通过 MCP 代理挂载 cmux-cua 工具集到 cmux 启动的 Claude Code / Codex 会话
- get_app_state / get_window_state 返回截图与紧凑辅助功能树,支持按元素或坐标操作
- 提供 click、type_text、press_key、scroll、drag、set_value、select_text 等操作工具
- 带品牌渐变光标(cmux 标志色)在屏幕上可视化代理的指针动作
- 引导一次性 macOS 辅助功能与屏幕录制授权(TCC),主 cmux 进程不持有权限
- 菜单栏项提供「聚焦被驱动应用 / 聚焦调用终端」两种呈现模式
- 在 cmux 中并行运行多个 Claude Code 会话、需要代理替你点按 Calculator、系统设置等真实 GUI 应用的开发者
- Codex 用户想让代理用可见指针操作屏幕控件而非只发键盘指令
- 需要代理验证 GUI 变更(截图 + 辅助功能树双重核验)的自动化工作流
- 希望代理操作被遮挡窗口时获得 background_occluded 安全拦截而非点错目标的用户
- 非 macOS 平台用户——技能完全依赖 macOS 辅助功能、屏幕录制与 TCC 机制
- 不使用 cmux 应用的用户——工具仅在 cmux 启动且实时 socket 在线的会话中挂载,独立 Claude Code / Codex 安装无法获得这些工具
- 不想授予屏幕录制 / 辅助功能权限,或受限环境(无 GUI 桌面、CI)下的无头运行
如何安装这个 Skill?
- 该技能授予 macOS 辅助功能与屏幕录制权限,可观察并操作真实应用界面;仅在用户明确请求时使用,并留意系统设置中的权限授予对象。
- 技能会通过符号链接安装到 ~/.agents/skills 或 ~/.claude/skills;link-policy.sh 声称只移除'托管'链接,但该归属判断未经独立审计。
- 许可元数据为 NOASSERTION:主仓库为 GPL-3.0-or-later + BUSL-1.1 混合许可,引擎位于独立 fork,商用合规前需自行核实。
- 仅支持 macOS 且必须通过 cmux 启动的会话使用;文档无中文说明;本评分为静态源码评审,未执行任何验证。
- Shell / 命令行
- 本地文件系统
- MCP Server
cmux macOS app (tagged build)cmux Computer Use helpermacOS Accessibility permissionmacOS Screen Recording permission
该技能随 cmux 应用捆绑分发,无需单独安装:
brew tap manaflow-ai/cmux
brew install --cask cmux可选的持久化全局技能安装由应用管理(启动时设置 CMUX_COMPUTER_USE_INSTALL_GLOBAL_SKILL=1,会创建 ~/.claude/skills/cmux-cua 或 ~/.agents/skills/cmux-cua 链接),源文档未提供其他手动安装命令。
如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- $cmux-cua 打开计算器并帮我算一下 128 × 46
- 用 cmux Computer Use 在系统设置里帮我检查屏幕录制权限状态
- $cmux-cua 在备忘录里新建一条笔记,标题写「会议纪要
- 通过 cmux Computer Use 截图当前 Safari 窗口并告诉我页面上的表单字段
在 cmux 启动的代理会话中,用户明确提出 cmux Computer Use 请求(如 $cmux-cua)即触发:若开关关闭,cmux 自动启用运行时并打开引导流程。首次功能性工具调用会自动打开权限设置(辅助功能 + 屏幕录制),用户在系统设置中逐项允许;macOS Tahoe 上还需允许一次系统直捕确认弹窗。之后代理按 Codex 十工具清单或 Claude/native 清单感知-操作-验证。硬性关闭开关:CMUX_COMPUTER_USE_MCP_DISABLED=1。切勿在只有阅读/询问时调用本技能。
这个 Skill 有哪些优点和局限?
- 全程本地运行,上游遥测与更新检查在运行时禁用
- 权限授予独立的辅助程序(独立 TCC 身份),无需重启主 cmux 应用
- 品牌光标让代理操作在屏幕上可见、可审计
- 像素输入带遮挡检查(background_occluded),防止点错被覆盖的窗口
- 强制的用户明示同意门控,防止代理自行启动 GUI 操作
- 仅限 macOS,且仅在 cmux 应用内启动的会话可用
- 需要两项敏感系统权限(辅助功能 + 屏幕录制)
- Catalyst 应用(如 Calculator)可能短暂返回空 AX 树和虚假错误码 -25204,需重新快照
- macOS 后台坐标拖拽不可用,须用 foreground delivery_mode
- 点击动作永不由辅助程序验证,必须依赖重新快照确认
- 仓库许可证标记为 NOASSERTION(README 说明主体为 GPL-3.0-or-later,服务端组件为 BUSL 1.1)
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux Computer Use 技能 本页 | 50 · 谨慎使用 | ★ 28k | 今天 | NOASSERTION |
| Cua Driver 技能 | 58 · 推荐 | ★ 29k | 1 天前 | MIT |
| Cua Driver GUI 自动化技能 | 61 · 推荐 | ★ 29k | 1 天前 | MIT |
| Cua GUI 自动化技能 | 51 · 谨慎使用 | ★ 29k | 1 天前 | MIT |
| Agent Browser 浏览器自动化技能 | 49 · 谨慎使用 | ★ 20k | 7 天前 | MIT |
源文档将其与 Codex 内置的 computer_use 连接器对照:cmux 会话内禁用 Codex 原生 provider,强制使用带命名空间的 cmux-cua 工具(十个工具、schema 对等,但不含 get_window_state、token、recordings 等原生扩展);另与独立的 codex CLI 自带 computer-use 辅助程序区分——macOS 弹窗中出现的「Codex Computer Use (com.openai.sky.CUAService)」并非来自 cmux。
FollowSkills 如何评估这个 Skill?
加分:文档反复强调显式用户同意(加载技能不等于同意)、独立 TCC 身份、硬性禁用开关(CMUX_COMPUTER_USE_MCP_DISABLED=1)、关闭失败设计(无环境变量覆盖、缺权限即失败)、禁止隐式调用(allow_implicit_invocation: false)。扣分:技能涉及辅助功能与屏幕录制等高权限 macOS 能力、符号链接写入用户技能目录、依赖未经第三方验证的发布方提供的固定构建引擎;隔离与回滚逻辑仅由脚本自我声明,未经独立验证。
加分:文档详细覆盖异常路径(Catalyst AX 错误码 -25204、background_occluded 阻挡、后台拖拽不可用、TCC 提示归属混淆等),并给出可诊断的错误信息与故障排查清单;link-policy.sh 逻辑自洽、防御性写法。扣分:静态评审无法执行任何关键路径,仓库未见覆盖该技能路径的测试证据,Claude/Codex 双配置文件的分叉行为(compat 标志差异)增加了不一致风险。
加分:触发条件极其明确(仅用户显式请求 $cmux-cua,disable-model-invocation: true),非适用范围声明充分(不接受静默切换提供方)。扣分:仅限 macOS + cmux 自有会话环境,受众狭窄;文档全英文,无中文支持说明;依赖本地 GUI 环境,无法验证在其他环境的可用性。
加分:文档分层清晰(附加方式、权限、工具使用、故障排查、开发),agents/openai.yaml 提供接口元数据,link-policy.sh 注释详尽。扣分:仓库许可元数据为 NOASSERTION(实际为 GPL-3.0-or-later + BUSL 混合,且引擎在独立 fork,许可关系复杂);技能本身无版本号或变更日志;发布方未经注册表验证,维护责任与更新路径仅在仓库层面间接可见。
加分:核心任务(通过辅助功能树+截图驱动 macOS 应用)有具体工具清单、操作顺序和验证流程,边际价值明确(替代手工 GUI 操作)。扣分:输出可直接可用性未经执行验证;部分行为文档自行声明'未经独立验证'(如拖拽契约变更),实际效果依赖用户完成多步系统权限配置。
加分:关键声明可追溯到仓库内具体源码路径(Packages/macOS/CmuxComputerUse/、wrapper 脚本、构建脚本 CMUX_CUA_PINNED_SHA)。扣分:静态评审上限为 5;无该技能关键路径的已提交测试套件或 CI 执行证据;许可溯源(NOASSERTION)与发布方身份均不可独立核实。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →