skills.rest
manaflow-ai
manaflow-aiOFFICIAL
Explore all skills by this author →
GitHub

cmux-cloud-vm

Route builds, tests, and agent tasks to persistent cmux Cloud VMs from the CLI.

26.6k|2.3k|Updated Jan 28, 2026
Search Tags:#remote execution#parallel builds#cmux#cli automation#coding agents#cloud vm#machine routing
One-click install
npx skills add https://github.com/manaflow-ai/cmux --skill cmux-cloud-vm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cmux-cloud-vm
Source: https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-cloud-vm
Command: npx skills add https://github.com/manaflow-ai/cmux --skill cmux-cloud-vm

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Running heavy builds, Linux-only tests, desktop automation, or parallel coding agents on a local Mac consumes resources and lacks isolation; this Skill lets an agent offload that work to persistent cloud VMs while keeping the user informed through panes, URLs, and notifications.

Core Features & Use Cases

  • Automatic machine routing: cmux vm route/run/agent pick a warm pool machine per directory with sticky binding, or provision one within plan limits.
  • Detached cloud agents: Start Claude Code, Codex, OpenCode, or Pi as persistent terminals in the machine's cmux-tui session that survive disconnects and can be reattached or driven headlessly.
  • Full VM lifecycle: Create, exec, push/pull files, expose tokened port URLs, snapshot checkpoints, and fork machines for parallel experiments.
  • Use Case: Run a long test suite on a cloud machine with cmux vm run --sync -- bun test, then fork the machine twice to let two agents try competing fixes in parallel while you watch progress in cmux vm tree.

Quick Start

Ask the agent to run your project's test suite on a cmux cloud machine and show you the results when finished.

Frequently Asked Questions about cmux-cloud-vm

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run tests on a cloud VM instead of my local machine?▼

Use cmux vm run --sync -- bun test to push your current directory to a routed cloud machine and execute there. The router reuses a warm machine per directory, so dependencies stay cached across runs.

How do I run a coding agent like Claude Code on a cloud machine?▼

Use cmux vm agent --agent claude --sync -- "your task" to start a detached agent session on the routed machine. Claude Code, Codex, OpenCode, and Pi are preinstalled under /root/.npm-global/bin on each machine.

What comes preinstalled on cmux Cloud machines?▼

Machines run Ubuntu 22.04 with an xfce desktop, node 22, bun, uv, git, gh, ripgrep, fd, jq, tmux, and xdotool. Claude Code, Codex, OpenCode, and Pi are preinstalled, plus TigerVNC, noVNC, and a computer-use driver for desktop automation.

Why does cmux vm exec hang or time out?▼

Exec has a roughly 30-second default cap and no TTY or stdin. For long work, background the command with nohup and poll its log, or use vm agent or a session terminal for interactive programs.

What are the limits of the free cmux Cloud plan?▼

Free plans get one machine and a 7-day cloud access window, shown by the plan meter in cmux vm ls. At the cap, machine creation fails with an upgrade action, so reuse idle machines or Base instead of creating new ones.

Can I transfer files between my Mac and a cloud machine?▼

Yes, cmux vm push and pull move files or directories as tarballs with SHA-256 verification, capped at 256 MB. Push skips .git, node_modules, and .venv by default unless you pass --no-default-excludes.

Related Skills

Explore More Software Engineering Skills→
manifoldlogicmanifoldlogic

terminal-management

Execute cmux terminal commands via SSH from a devcontainer.

Official
Advanced
tanaka-yuitanaka-yui
4

cmux-using

Orchestrate terminal workflows by managing panes, sub-agents, and cross-workspace commands in cmux.

Community
Advanced
hheydaroffhheydaroff

cmux

Automate multi-pane window layout control in macOS and terminal environments.

Community
Intermediate
sixscripts-aisixscripts-ai

ssh-mac-dev

Connect Claude to a Mac over SSH through a bore tunnel for remote development.

Community
Advanced