用途：通过 cmux CLI 驱动 cmux Cloud 机器（用户自有的持久 Linux 云 VM），完成创建与连接、运行命令和编码智能体、传输文件、开放端口与桌面、快照/分叉/恢复，以及从机器内发送通知。
主要能力：机器是登录用户拥有的持久云 VM，名称即地址；每台机器运行 cmux 会话守护进程，终端会话与回滚缓冲在断开后继续运行。新机器默认启动桌面镜像（xfce + noVNC）加 shell，--base 提供仅 shell 机器；Base 是每用户唯一的持久槽位。支持 vm run/exec 执行命令、vm agent 运行 claude/codex/opencode/pi 等预装智能体、vm push/pull 传输文件、vm open 预览端口、vm snapshot/restore/fork 保存与复现状态、vm desktop/tui/shell 连接。
使用方式：宿主机命令经运行中的 cmux macOS 应用 socket 执行，需应用运行并已登录。健康检查：cmux --version、cmux ping、cmux vm ls。示例：cmux vm run -- uname -a；cmux vm run --sync -- bun test；cmux vm agent --agent claude --sync -- "run the test suite and fix failures"；cmux vm new --detach；cmux vm open <id> 3000。机器内 cmux 二进制为转发 CLI，命令转发到 Mac 上的 cmux 应用，如 cmux notify --title "Build done"。
限制：创建机器计费并占用套餐额度，优先复用而非新建；vm exec 客户端约 35 秒超时，vm run 最长 15 分钟，更长任务应启动分离终端。不得对非本会话创建的机器执行 vm rm；vm new 不接受位置参数；不要轮询 vm status，改用 vm wait；SSH 仅为回退，部分提供商/镜像无法生成属正常。套餐上限、规格与提供商可能变化，应以 cmux vm ls 与 --help 输出为准。具体每命令语法见 references/commands.md，以已安装构建的 cmux vm <sub> --help 为准。