用途：当用户希望将自建 cmux 后端指向 Freestyle、需要绑定特定 cmux 发布版本的快照，或想在自有 Freestyle 账户上重建 cmux Cloud VM 镜像时使用。官方内部开发推送快照并更新 manifest 的流程不适用本技能。
主要能力：通过脚本从 Dockerfile 构建快照，内容包含 ubuntu:24.04、C.UTF-8 与相同 shell 包集合、cmux 浏览器代理所需的 Python/OpenSSL shim；从固定的 manaflow-ai/cmux GitHub 发布下载 cmuxd-remote 并做 SHA-256 校验；提供 /usr/local/bin/cmux 软链；安装 Node.js、Bun 及固定版本的编码智能体 CLI（Claude Code、OpenCode、Codex、Pi）；创建带免密 sudo 的 cmux 用户；配置 systemd 单元 cmuxd-ws.service，监听 0.0.0.0:7777，并把 Freestyle 端口 443 映射到 7777。镜像构建时运行与内部构建器相同的冒烟测试。
使用方式：git clone https://github.com/manaflow-ai/cmux-freestyle.git 后进入目录，设置 FREESTYLE_API_KEY 并执行 ./setup.sh；也可用 FREESTYLE_API_KEY=fk_... curl -fsSL https://raw.githubusercontent.com/manaflow-ai/cmux-freestyle/main/install.sh | bash。默认子命令为 snapshot，可用 --release/CMUX_RELEASE_TAG 固定版本、--name/CMUX_FREESTYLE_SNAPSHOT_NAME 设置快照名、--skip-cache/CMUX_FREESTYLE_SKIP_CACHE 强制重建、--codex-spec none 等剔除个别 CLI、--json 输出机器可读结果；成功打印 FREESTYLE_SANDBOX_SNAPSHOT=sh-...。构建约 5 至 15 分钟。另有 doctor 校验环境、web 引导 Next.js 开发环境、home 安装 cmux-home（Ink TUI）总部视图。
接入 cmux 后端时设置 FREESTYLE_API_KEY、FREESTYLE_SANDBOX_SNAPSHOT、CMUX_VM_DEFAULT_PROVIDER=freestyle、CMUX_VM_FREESTYLE_ENABLED=1，两项必须来自同一 Freestyle 账户。冒烟测试可用 npx -y freestyle vm create --snapshot <snapshotId> --ssh。
限制：快照按账户隔离，他人的快照 ID 无法使用；不得把提供商密钥或用户专属凭据写入快照；必须使用已发布的 cmuxd-remote 版本以保证校验；智能体 CLI 版本必须为精确 semver，拒绝范围或 latest；不得针对 manaflow 账户迭代；Freestyle CLI 不提供快照创建，需直接用 SDK。GitHub 未认证 API 每小时 60 次，受限时可设置 GITHUB_TOKEN 或 GH_TOKEN。Freestyle SSH 网关拒绝远程端口转发，相关选项仅适用于普通 Linux/macOS sshd 主机。辅助脚本需要 sshpass 和 tsadmin。Subrouter 目前仅路由 Codex。