这个 Skill 能做什么,适合哪些场景?
cmux-cloud-vm 是 cmux 仓库中 25 个技能之一,教会代理如何管理 cmux Cloud 虚拟机。它规定了发现机器、鉴权、选择目标、以有界命令或分离代理方式执行任务的完整流程,并强调在无头模式下工作、复用已有机器与工作区。机器终端在窗格关闭或 Mac 断开连接后依然持久存在,适合长时间运行的代理任务。后端实现属于 cmux-backend,本技能只负责客户端操作。
- 运行
cmux vm --help、cmux auth status、cmux vm ls --、cmux vm route --来发现可用机器和放置位置,且route不创建机器 - 用
cmux vm run --machine <id> -- <command>执行有界命令并保留退出码 - 用
cmux vm agent --machine <id> --agent codex --no-open -- "<task>"启动分离的编码代理 - 用
cmux vm tree、terminal read、terminal wait-exit、terminal output无头观察运行状态和完整输出 - 用
vm open/workspace open展示已验证的结果;注意workspace rm会杀掉终端而workspace close只是分离 - 通过
references/commands.md、references/guest.md等参考文档查询精确标志、JSON 契约和限制
- 在 Mac 上并行运行多个 Claude Code/Codex 会话的 cmux 用户,需要把长时任务放到云端持久终端而不占用本地机器
- 代理需要执行可能超过会话时长的构建或测试,要求机器终端在断开连接后继续运行
- 开发者想在云端机器上启动项目开发环境,先用 `cmux vm dev <id> --dry-run --` 审阅计划再执行
- 需要把某个已完成任务的工作区以 URL 或窗格形式展示给用户检查的场景
- 多机器使用者想优先复用路由器池机器或固定已有机器,避免不必要的新建与删除
- 非 macOS 用户:宿主机操作需要 cmux 应用、登录及其私有隧道,而 cmux 目前仅支持 macOS
- 没有 cmux Cloud 账户或权限的用户:技能本身不负责开通云端资源
- 想把它当作 cmux 后端实现的人:SKILL.md 明确说明后端属于 cmux-backend,本技能只是客户端操作指南
如何安装这个 Skill?
- 该技能仅在 macOS cmux 应用、已登录账户与 WireGuard 隧道就绪时可用,且依赖 cmux 云后端;中国大陆用户需先验证网络可达性。
- 许可元数据为 NOASSERTION,发布者未经核验,商业计划限制(免费计划需 Pro 才能创建机器)应在采用前确认。
- 破坏性命令(vm rm、base reset、workspace rm、domains rm)后果持久,agent 应严格遵循文档中的授权与确认要求。
- commands.md 参考在提供的材料中被截断,实际使用前应核对完整文件与已安装 CLI 的 --help。
- Shell / 命令行
- 网络访问
- 本地文件系统
cmux CLIcmux macOS app (for host operations)cmux Cloud account/sign-in
来源未提供专门的技能安装命令。该技能位于 manaflow-ai/cmux 仓库的 skills/cmux-cloud-vm/SKILL.md,可按 Agent Skills 惯例把该文件夹复制进你的客户端技能目录。Claude Code(未在来源中给出具体命令,按通用技能目录方式)
git clone https://github.com/manaflow-ai/cmux.git
cp -r cmux/skills/cmux-cloud-vm ~/.claude/skills/前置条件:宿主机操作需安装 cmux macOS 应用并登录。
brew tap manaflow-ai/cmux
brew install --cask cmux如何使用这个 Skill?
安装后,把下面任意一句发给 Agent 即可触发:
- 在 cmux Cloud 上列出我的可用机器,并告诉我哪个池机器可以复用
- 用 cmux vm 在机器 <id> 上以分离模式启动一个 codex 代理,任务是实现登录页的重构
- 在云端机器上以 dry-run 方式检查这个项目的 dev 布局计划,先给我看 JSON 再执行
- 等机器 <id> 上的终端退出后,把完整输出和工作区展示给我
当用户请求 cmux vm/cloud 相关任务时触发。流程:先发现(cmux vm ls --、cmux vm route --),复用池机器或用 --machine <id> 固定目标,优先在同一机器上使用其他工作区;然后按需求选择操作(有界命令、分离代理、dev 布局、无头观察);最后用 vm open/workspace open 展示结果。工作期间使用 --no-open、--detach 或 --print 避免抢焦点;注意 wait-exit 完成不等于测试通过,必须读取实际输出。
cmux vm route --
cmux vm run --machine <id> -- <command>
cmux vm terminal wait-exit <id> <term>约束:删除机器、重置、调大小等破坏性操作需用户授权;账号令牌留在宿主机,不复制进机器。
这个 Skill 有哪些优点和局限?
- 机器终端在窗格关闭或 Mac 断开后持久存在,适合长时代理任务
- 强调复用现有机器和路由器池,避免不必要的资源创建和删除
- 对授权、令牌安全(不复制凭据进机器)和退出码验证有明确的操作约束
- 附带 commands/guest/agent-workflows 等参考文档,覆盖精确标志与 JSON 契约
- 强依赖 cmux 专有生态:需要 cmux 应用、登录、私有隧道和 Cloud 账户,无法独立使用
- 仅限 macOS 宿主机,来源未验证其他平台
- 仓库许可证标记为 NOASSERTION:主体为 GPL-3.0-or-later,但服务器/Cloudflare workers 部分采用 Business Source License 1.1,生产使用需商业授权
- 来源未提供技能本身的测试套件或独立安装文档
这个 Skill 与同类方案有什么区别?
与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| cmux Cloud 虚拟机技能 本页 | 56 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| Cua Spaces(cua-spaces 技能) | 46 · 谨慎使用 | ★ 29k | 1 天前 | MIT |
| cmux Computer Use 技能 | 50 · 谨慎使用 | ★ 28k | 1 天前 | NOASSERTION |
| Cua Driver GUI 自动化技能 | 61 · 推荐 | ★ 29k | 1 天前 | MIT |
| 存储分析器(Storage Analyzer) | 60 · 推荐 | ★ 21k | 10 天前 | MIT |
与 tmux 相比:tmux 是运行在任意终端内的多路复用器;cmux 是带 GUI 的原生 macOS 应用,内置垂直标签、分割窗格、内嵌浏览器和套接字 API,无需前缀键。cmux 也可通过 SSH 附着到远程 tmux 会话,或用持久化 Cloud VM 保证 Mac 离线时任务仍在线。
FollowSkills 如何评估这个 Skill?
SKILL.md 及 references 明确要求破坏性操作(vm rm、base reset、workspace rm)需用户授权,要求凭据保留在宿主机、密钥不进布局/日志/命令参数,域名发布默认 personal 且警告 public URL 是 bearer credential,push 使用 SHA-256 校验与固定主机密钥,网络可设 allowlist。扣分处:静态审查无法验证上述声明与实现一致;发布者未经核验,许可元数据为 NOASSERTION,归属与外部效果(后端服务)不可完全审计。
文档内部一致性很高:动词表、退出码契约、-- 负载、失败反馈(wait-exit 返回码、'finished wait is not proof tests passed')都有明确约定,且强调先读 --help。扣分处:静态审查上限 10;引用的 tests/test_cloud_vm_skill_coverage.py 未在提供材料中,关键路径(路由、provisioning、隧道)未经执行复现,部分示例依赖 netstat/wget 等环境假设。
description 明确触发词(cmux vm/cloud),非适用边界写明(backend 属 cmux-backend skill),guest/host 语法区分清晰,preflight 引导只读发现。扣分处:强依赖 macOS 应用、登录账户、WireGuard 隧道与 cmux 云后端,免费/付费计划限制复杂;核心功能完全依赖海外云服务,中国大陆可达性存疑且未声明;无中文支持。
信息架构分层好:SKILL.md 为主、references 按任务索引、命令目录带锚点,guest 语法表与 sidebar 1:1 对照表质量高,已知限制(legacy flags、peer enrollment 弃用)有披露。扣分处:许可元数据 NOASSERTION,无版本/changelog 绑定说明(仅称'current source revision'),维护责任与更新路径未明确,commands.md 在截取处不完整。
文档详细到可直接照做(路由→run/agent→wait-exit→output→open 的完整工作流,含幂等 dev server 脚本、fork 并行实验),相对手工操作 SSH/tmux 有明确边际价值。扣分处:静态审查上限 7;无已验证的实际输出,成本(付费计划、订阅依赖)与收益的权衡证据有限,示例输出(jq 字段名)未经执行核验。
声称均可追溯到仓库内命令与 socket 方法名,side-parity 表标注验证状态,并引用覆盖测试文件,属可审计的原始材料。扣分处:静态审查上限 5;无第三方执行证据,'Verified ✅' 列为作者自述,无跨源佐证,事实与推断混合处需人工复核。
点击维度查看打分理由
证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。
查看完整评分方法 →