cmux-cloud-vm 技能用于操作 cmux Cloud 机器、运行持久的远程命令或代理，并呈现其工作区或服务，适用于 cmux vm/cloud 相关任务。
用途 该技能面向 cmux Cloud 机器的使用场景。使用时优先复用现有机器与工作区，而非新建。机器终端在窗格关闭或 Mac 断开连接后仍会持续运行，因此可以无界面地推进任务；当有用户需要检查的结果时，再打开窗格或分享 URL。
从发现开始 文档建议以发现类命令起步： cmux vm --help cmux auth status cmux vm ls --json cmux vm route --json
在 Mac 上，主机操作需要应用、登录及其私有隧道。在机器内部，使用 cmux self --json 和客户机的帮助；阅读客户机操作以了解其支持的子集和认证。当版本不同时，以已安装的帮助为准。
route 可在不创建机器的情况下检查放置。需阅读 would_provision 以及后端的限制/能力；不要假设计划上限、内存大小或提供商特性。可复用路由器的池机器，或用 --machine <id> 显式固定现有目标。Base 是用户的持久工作。优先在机器上使用另一个工作区，而不是换用另一台机器。
运行与观察 在确定已授权的目标后，可根据需要选择操作：
- 有界命令与退出码：cmux vm run --machine <id> -- <command>
- 分离式编码代理：cmux vm agent --machine <id> --agent codex --no-open -- "<task>"
- 带开发布局的项目：cmux vm dev <id> --dry-run --json，然后执行获批的计划
- 不打开窗格进行观察：cmux vm tree <id> --json、cmux vm terminal read <id> <term>
- 获取完成状态与完整输出：cmux vm terminal wait-exit <id> <term>，然后读取终端输出
添加标志前应阅读所选命令的 --help。需保留机器、工作区/终端标识以及实际退出结果。等待结束并不代表测试通过。使用 vm open/workspace open 呈现已验证的结果；关闭视图不会停止机器终端。
全程适用的约束 配置、分叉、重置、调整大小和破坏性清理需要用户对目标与效果的授权；已给出的授权可继续沿用。不要为了腾出容量而删除机器，也不要重置 Base 作为变通。
账户/上游令牌应保留在主机上。除非用户要求，不要把用户凭证复制到机器中。经授权时使用 secret/env 传输路径；值不应出现在布局 JSON、日志或命令参数中。
工作时使用 --no-open、--detach 或 --print。焦点变化应是有意为之。workspace rm 会终止其终端；workspace close 则使其分离。
只阅读相关细节
- 工作流配方：项目设置、交互式终端、长时间运行、对等代理、分叉和服务发布。
- 命令参考：确切的标志、JSON/退出契约、文件/环境传输、布局、限制与能力。检索时先搜索其任务索引。
- 客户机操作：主机/客户机语法、CodeRouter、对等访问、镜像行为、通知和浏览器认证。
- 侧边栏一致性：将特定 UI 操作映射到 CLI。
- 本地工作区规则：在不干扰调用方工作区的前提下呈现云端工作。