# Cmux Cloud Vm

Operate cmux Cloud machines, run durable remote commands or agents, and present their...

- Repository: https://github.com/manaflow-ai/cmux (28635 stars)
- Category: AI and agents
- License: see repository
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -g -a claude-code -y`
Codex: `npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -g -a codex -y`
Cursor: `npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -g -a cursor -y`
Gemini CLI: `npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -g -a gemini-cli -y`

## Description

Operate cmux Cloud machines, run durable remote commands or agents, and present their workspaces or services. Use for cmux vm/cloud tasks; backend implementation belongs to cmux-backend.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# cmux Cloud machines

Use an existing machine and a workspace for the task. Machine terminals persist
when panes close or the Mac disconnects. Work headlessly; open a pane or share a
URL when there is a result for the user to inspect.

## Start with discovery

```sh
cmux vm --help
cmux auth status
cmux vm ls --json
cmux vm route --json
```

On the Mac, host operations need the app, sign-in and its private tunnel. Inside a
machine, use `cmux self --json` and the guest's help; read [guest operations](references/guest.md)
for its supported subset and auth. Installed help is authoritative when versions differ.

`route` inspects placement without creating a machine. Read `would_provision` and
the backend's `limits`/`capabilities`; do not assume a plan cap, memory size or
provider feature. Reuse the router's pool machine, or explicitly pin an existing
target with `--machine <id>`. Base is the user's persistent work. Prefer another
workspace on a machine to another machine.

## Run and observe

After identifying an authorized target, choose the operation:

| Need | Start here |
| --- | --- |
| Bounded command and exit code | `cmux vm run --machine <id> -- <command>` |
| Detached coding agent | `cmux vm agent --machine <id> --agent codex --no-open -- "<task>"` |
| Project with a dev layout | `cmux vm dev <id> --dry-run --json`, then the approved plan |
| Observe without opening panes | `cmux vm tree <id> --json`, `cmux vm terminal read <id> <term>` |
| Completion and full output | `cmux vm terminal wait-exit <id> <term>`, then `terminal output` |

Read the selected verb's `--help` before adding flags. Retain the machine,
workspace/terminal identity and actual exit result. A finished wait is not proof
that tests passed. Use `vm open`/`workspace open` to present verified results;
closing a view does not stop the machine terminal.

## Constraints that apply throughout

The rest: https://github.com/manaflow-ai/cmux/blob/HEAD/skills/cmux-cloud-vm/SKILL.md