Add cmux-cloud skill: use cmux Cloud machines via the CLI

Merged
LA
2mo ago
+238-1

Adds skills/cmux-cloud, a usage skill for cmux Cloud through the CLI, verified against manaflow-ai/cmux origin/main (post-Blaxel-default surface).

SKILL.md carries the mental model (machines, Base, cmuxd-remote, cmux-tui sessions, tree addresses, agent-pool routing, plan meter), the common workflows (vm run/agent/exec, create/attach, port preview, push/pull, snapshot/fork/restore), the inside-a-machine relay CLI section (cmux notify and friends act on the connected Mac app, not the VM), and hard rules (no unprompted vm rm, no positional args to vm new, prefer routing over creating, --json for scripting, internal attach helpers off limits).

references/commands.md is the verb-by-verb reference for every cmux vm subcommand plus cmux ai-accounts, with the live --help output declared authoritative so the skill degrades gracefully as the CLI moves.

Also adds the README table row and the skills.sh.json Cloud grouping entry.

Summary by cubic

Adds the cmux-cloud skill so agents can drive cmux Cloud machines through the cmux vm CLI, covering creation, attach, exec/run, coding agents, file transfer, ports, snapshots, and in-VM notifications.

  • skills/cmux-cloud/SKILL.md documents the machine/Base model, common workflows, the inside-machine relay CLI, transport behavior (provider/image-dependent, SSH as fallback), and hard safety rules (no unprompted vm rm, no positional args to vm new).
  • skills/cmux-cloud/references/commands.md is a per-verb reference that defers to the installed --help output as authoritative, including which commands support --json.
  • Registers the skill in the README skill table and in the skills.sh.json Cloud group; the group description now covers CLI usage alongside bring-your-own-infrastructure.

Summary by CodeRabbit

  • Documentation
    • Added documentation for using cmux Cloud virtual machines through the CLI.
    • Documented Cloud workflows including VM creation, access, command execution, file transfer, port previews, snapshots, and restores.
    • Added a command reference covering VM management, coding agents, credential uploads, and related workflows.
    • Updated the skills catalog and repository layout to include the new cmux Cloud skill.
    • Expanded the Cloud grouping description to cover both hosted and self-managed infrastructure.