自动化与运维

cmux Cloud 虚拟机技能

让 AI 代理通过 cmux CLI 操作云端虚拟机:在持久化的远程终端上运行长时命令和编码代理,并在完成后向用户展示结果工作区。

56/ 100
谨慎使用

价值存在,但可靠性、证据或控制措施仍有明显缺口。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 28k
最近更新
1 天前
License
NOASSERTION
cloud-vmscmux-cliremote-commandsterminal-multiplexer
+3macoscoding-agentsworkspace-management

这个 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。
开始前你需要
Agent 需要具备
  • Shell / 命令行
  • 网络访问
  • 本地文件系统
需要预先安装
  • cmux CLI
  • cmux 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?

FollowSkills 评估 · FSRS-2.0
谨慎使用
56/ 100 五分制 2.8 / 5
1信任安全17 / 25 · 3.4/5

SKILL.md 及 references 明确要求破坏性操作(vm rm、base reset、workspace rm)需用户授权,要求凭据保留在宿主机、密钥不进布局/日志/命令参数,域名发布默认 personal 且警告 public URL 是 bearer credential,push 使用 SHA-256 校验与固定主机密钥,网络可设 allowlist。扣分处:静态审查无法验证上述声明与实现一致;发布者未经核验,许可元数据为 NOASSERTION,归属与外部效果(后端服务)不可完全审计。

2可靠稳定10 / 20 · 2.5/5

文档内部一致性很高:动词表、退出码契约、-- 负载、失败反馈(wait-exit 返回码、'finished wait is not proof tests passed')都有明确约定,且强调先读 --help。扣分处:静态审查上限 10;引用的 tests/test_cloud_vm_skill_coverage.py 未在提供材料中,关键路径(路由、provisioning、隧道)未经执行复现,部分示例依赖 netstat/wget 等环境假设。

3适用触发9 / 15 · 3.0/5

description 明确触发词(cmux vm/cloud),非适用边界写明(backend 属 cmux-backend skill),guest/host 语法区分清晰,preflight 引导只读发现。扣分处:强依赖 macOS 应用、登录账户、WireGuard 隧道与 cmux 云后端,免费/付费计划限制复杂;核心功能完全依赖海外云服务,中国大陆可达性存疑且未声明;无中文支持。

4规范维护10 / 15 · 3.3/5

信息架构分层好:SKILL.md 为主、references 按任务索引、命令目录带锚点,guest 语法表与 sidebar 1:1 对照表质量高,已知限制(legacy flags、peer enrollment 弃用)有披露。扣分处:许可元数据 NOASSERTION,无版本/changelog 绑定说明(仅称'current source revision'),维护责任与更新路径未明确,commands.md 在截取处不完整。

5有效结果6 / 15 · 2.0/5

文档详细到可直接照做(路由→run/agent→wait-exit→output→open 的完整工作流,含幂等 dev server 脚本、fork 并行实验),相对手工操作 SSH/tmux 有明确边际价值。扣分处:静态审查上限 7;无已验证的实际输出,成本(付费计划、订阅依赖)与收益的权衡证据有限,示例输出(jq 字段名)未经执行核验。

6证据核验4 / 10 · 2.0/5

声称均可追溯到仓库内命令与 socket 方法名,side-parity 表标注验证状态,并引用覆盖测试文件,属可审计的原始材料。扣分处:静态审查上限 5;无第三方执行证据,'Verified ✅' 列为作者自述,无跨源佐证,事实与推断混合处需人工复核。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年10月10日 审查版本 d6ff14af8af1 评估证据[1][2][3][4][5][6][7]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

使用这个技能需要付费吗?
cmux 本身免费开源;Cloud VM 属于 Founder's Edition 的早期访问功能,来源未说明 Cloud VM 日常使用的具体计费方式。
机器终端的持久性如何?
机器终端在窗格关闭或 Mac 断开连接后依然持久,本地 tmux 服务器无法做到这一点,这正是 README 建议在 Mac 必须离线时使用持久 Cloud VM 的原因。
我的凭据会被复制到云端机器吗?
技能明确要求账号/上游令牌保留在宿主机,除非用户要求,不得把凭据复制进机器;密钥应通过授权的秘密/环境变量传输路径传递,不出现在布局 JSON、日志或命令参数中。
wait-exit 完成就代表任务成功了吗?
不是。SKILL.md 明确指出等待完成并不证明测试通过,必须用 terminal output 读取完整输出并保留实际退出结果。

同仓库的其他 Skills

均来自 manaflow-ai/cmux

开发与工程

cmux 核心控制技能

通过 cmux CLI 确定性地控制多窗格终端布局——创建工作区、分割面板、移动与聚焦表面、触发提醒,专为 AI 编码代理的自动化而设计。

★ 28k FS 47 谨慎使用 1 天前
开发与工程

cmux 工作区操作技能

让 AI 代理安全地在调用它的 cmux 工作区内工作,避免误触用户正在查看的其他工作区或窗口。

★ 28k FS 64 推荐 1 天前
开发与工程

cmux 设置管理技能(cmux-settings)

安全查看、修改和回滚 cmux 终端的 cmux. 配置,改完即存即生效,无需重启应用。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux 诊断

为 cmux 用户收集安全、只读的诊断信息,快速定位钩子、通知、会话恢复和 CLI 控制不工作的问题。

★ 28k FS 51 谨慎使用 1 天前
开发与工程

cmux 共享行为规则

为 cmux 多入口行为制定统一的实现与验证规则,避免某个入口改了、其他入口仍是旧逻辑或旧 bug。

★ 28k FS 48 谨慎使用 1 天前
开发与工程

cmux-browser:cmux 内置浏览器自动化技能

在不抢夺焦点的前提下,通过 cmux CLI 打开网页、探查浏览器表面、等待页面状态并提取数据,专为并行开发场景设计。

★ 28k FS 60 推荐 1 天前
开发与工程

cmux 自定义技能

针对 cmux 终端的配置技能:安全地编辑 cmux.、Dock 配置与 Ghostty 偏好,定制动作、布局、快捷键和通知,而不破坏现有配置。

★ 28k FS 55 谨慎使用 1 天前
开发与工程

cmux 键盘快捷键定制

把你的按键习惯变成 cmux 的快捷键绑定:提供向导、模板与一键应用,避免误绑和冲突。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux Socket 策略规范技能

为 cmux 的 socket/CLI 命令开发提供线程调度与焦点行为规范,避免高遥测负载卡死主线程、避免自动化命令抢占用户焦点。

★ 28k FS 58 推荐 1 天前
开发与工程

cmux-capture:cmux 窗口截图与录制

用一条 CLI 命令截图或录制 cmux 窗口,为 PR、bug 报告或视觉验证提供真实证据,且无需任何屏幕录制权限。

★ 28k FS 55 谨慎使用 1 天前
效率与协作

cmux Markdown 查看器

把 .md 文件在 cmux 终端旁的格式化面板中打开,文件一变就自动重渲染,让计划、文档和笔记始终可见。

★ 28k FS 52 谨慎使用 1 天前
开发与工程

cmux 自定义侧边栏

从一句自然语言需求生成可热重载的 cmux 自定义侧边栏,无需 Xcode、无需构建、无需签名。

★ 28k FS 50 谨慎使用 1 天前
开发与工程

cmux 测试技能

为 cmux 仓库选择合适的本地/CI 验证方式,添加有行为依据的测试,并确保 Swift 测试文件在 Xcode 工程中正确接线。

★ 28k FS 60 推荐 1 天前
开发与工程

cmux 调试技能

为 cmux(基于 Ghostty 的 macOS 终端)开发者提供调试日志、Debug 菜单、运行时陷阱和性能敏感路径的规范知识,避免在打字延迟敏感代码中引入卡顿。

★ 28k FS 56 谨慎使用 1 天前
开发与工程

cmux Ghostty 子模块工作流技能

为 cmux 贡献者提供 Ghostty 子模块与 GhosttyKit.xcframework 的标准化构建、推送与指针更新流程,避免子模块指针悬空导致的拉取失败。

★ 28k FS 54 谨慎使用 1 天前
开发与工程

cmux 开发工作流技能

为 cmux 贡献者提供原生构建、带标签开发包、Xcode 工程规范化与侧边栏扩展的标准化工作流,避免破坏正在运行的 cmux 会话。

★ 28k FS 53 谨慎使用 1 天前
开发与工程

cmux 发布助手

为 cmux 仓库维护者整理发版全流程:版本号递增、变更日志汇总、预发布守卫、打标签与产物校验,减少手工遗漏。

★ 28k FS 53 谨慎使用 1 天前
自动化与运维

cmux Computer Use 技能

让 cmux 中的 AI 编码代理通过本地计算机使用引擎操作真实 macOS 应用,前提是用户明确提出请求。

★ 28k FS 50 谨慎使用 1 天前
开发与工程

cmux 架构规范技能

在向 cmux 添加或大幅改写 Swift 文件、包、协调器、服务或公共 API 之前,先加载这套包架构、分层、依赖倒置与 Swift 6 并发规则,避免违反项目约定。

★ 28k FS 63 推荐 1 天前
开发与工程

cmux 本地化规范与审计技能

在修改 cmux 任何用户可见文案时,强制执行本地化规则并跑完一条可核验的翻译审计流程,杜绝硬编码英文串。

★ 28k FS 56 谨慎使用 1 天前

相关 Skills