К основному содержанию
скилл CX Codex

cmux-cloud — скилл для Claude Code: что делает и как установить

Скилл cmux-cloud управляет постоянными облачными Linux-машинами cmux прямо из CLI: поднимает окружения, запускает агентов, переносит файлы и открывает порты.

MIT 192 установок ★ 40 обновлён 2026-09-08

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add manaflow-ai/cmux-skills --skill cmux-cloud -a claude-code
Открыть на GitHub

Что делает cmux-cloud

Скилл даёт доступ к облачным виртуальным машинам cmux. Каждая машина сохраняет своё состояние после закрытия терминала или сна локального компьютера. По умолчанию система запускает десктопный образ с xfce и noVNC, а ключ --base поднимает минимальный шелл. Для автономных задач внутри уже предустановлены сборки claude, codex, opencode и pi.

Внутри гостевой ОС утилита cmux работает как реле. Она пересылает команды обратно на Mac: системные оповещения через cmux notify выводятся прямо в Центр уведомлений macOS. Без запущенного и авторизованного приложения cmux на Mac хостовые команды не смогут подключиться к сокету.

Создание новых машин расходует оплаченный лимит тарифа. Поэтому регламент скилла требует переиспользовать пул через vm run вместо частого вызова vm new. Подключение по SSH считается лишь запасным вариантом и доступно не у всех провайдеров, так что его отсутствие ошибкой не считается.

Какие задачи решает

  • Запустить тесты или билд на удалённой виртуальной машине командой cmux vm run
  • Оставить кодинг-агента работать в фоне внутри облачного сеанса cmux-tui
  • Перенести файлы проекта в облако и выгрузить собранные артефакты
  • Открыть рабочий порт или рабочий стол xfce через браузерный фрейм

Примеры запросов агенту

  • Запусти прогон тестов на удалённой машине cmux с синхронизацией папки: cmux vm run --sync -- bun test
  • Сделай снимок состояния виртуалки с именем before-upgrade перед обновлением библиотек
  • Открой порт 3000 на инстансе cmux и покажи ссылку на веб-сервер

Как установить cmux-cloud

1Через Skills CLI (Vercel)

npx skills add manaflow-ai/cmux-skills --skill cmux-cloud -a claude-code

2Вручную: положить файлы

~/.claude/skills/cmux-cloud/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cmux-cloud/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cmux-cloud

Как установить cmux-cloud в Claude Code?

Выполните команду npx skills add manaflow-ai/cmux-skills --skill cmux-cloud -a claude-code. Конфигурация запишется в ~/.claude/skills/cmux-cloud/SKILL.md.

Что делает cmux-cloud?

Скилл связывает агента с утилитой cmux для управления удалёнными Linux-виртуалками. Он позволяет запускать команды, изолировать фоновых агентов, пробрасывать порты и управлять снимками системы.

Что нужно для работы скилла на локальном компьютере?

На macOS должно работать запущенное приложение cmux с выполненным входом в аккаунт. Команды обращаются к его локальному сокету, а статус подключения проверяется через cmux ping.

Исходный текст

SKILL.md · MIT
---
name: cmux-cloud
description: "Use cmux Cloud machines through the CLI. Use when the user says cmux cloud, cloud VM, cloud machine, cmux vm, Base workspace, machines panel, run/exec on a cloud machine, cloud agent, vm snapshot/fork/restore, push/pull files to a VM, open a port or desktop on a machine, or notify from inside a VM."
---

# cmux Cloud

Drive cmux Cloud machines (user-owned persistent Linux VMs) through the `cmux` CLI: create and attach, run commands and coding agents, move files, open ports and desktops, snapshot/fork/restore, and send notifications from inside a machine. Full per-command syntax lives in `references/commands.md`; `cmux vm <sub> --help` on the installed build is authoritative when they disagree.

## Mental model

- A **machine** is a persistent cloud VM owned by the signed-in cmux user. Its generated name (`brave-otter`) is its address everywhere; `cmux vm rename` sets a display label only. The cloud backend picks the provider; the machine outlives your panes, your Mac being closed, and reconnects.
- Every machine runs a **cmux session daemon** (cmux-tui on current images, cmuxd-remote on older ones) that owns terminal sessions and scrollback. Clients (Mac panes, iOS) attach through short-lived leases minted by the backend; the transport depends on what the provider and image support. SSH is a fallback some providers and images cannot mint at all, and its absence is not an error.
- New machines boot a **desktop image** (xfce + noVNC) plus a shell, with a persistent per-machine home. `--base` gives a shell-only machine.
- **Base** is a separate single per-user persistent slot, pinned to the top of the sidebar. `vm new` mints fresh machines; `vm base` always reopens the same one.
- Terminals on a machine live in its **cmux-tui session** (workspaces `ws_…`, terminals `term_…`). They keep running detached; `cmux vm tree` catalogs every surface (local and cloud) and every line is an address `cmux vm open` (machine targets) or `cmux surface open` (any entry, including This Mac) accepts, e.g. `brave-otter/main/term_2f9c…`, `brave-otter:desktop`, `brave-otter:port/3000`.
- **Pool machines** (labeled `agent-pool` in `vm ls`) are provisioned by the `vm run`/`vm agent` router and reused for routed work. The router never drafts machines a person made by hand.
- Plans cap active machine count and memory. `cmux vm ls` prints the meter (`N of M machines on the <plan> plan`) and, on free plans, when free cloud access expires.

## Prerequisites

Host-side commands go through the running cmux macOS app's socket: the app must be running and signed in (machines belong to that account/team). `cmux --version`, `cmux ping`, then `cmux vm ls` is the fastest health check. Commands that document `--json` support it for scripting. Creating machines costs money and counts against the plan; prefer reuse over creation.

## Workflows

### Run a one-off command

```bash
cmux vm run -- uname -a                       # router picks/wakes/creates a pool machine
cmux vm run --sync -- bun test                # push current dir to work/<basename> first
cmux vm run --sync --pull work/app/dist -- sh -c 'cd work/app && bun run build'
cmux vm exec <id> -- pwd                      # when you already know the machine
```

`exec` gives up after ~35s client-side; `vm run` allows up to 15 minutes. For anything longer, start a detached terminal (`vm agent`, or `cmux surface new-terminal --machine <id> -- <command...>`) and check on it via `vm tree` / `vm open`.

### Run a coding agent in the cloud

```bash
cmux vm agent --agent claude --sync -- "run the test suite and fix failures"
cmux vm agent --agent codex --machine brave-otter -- exec "summarize work/app"
```

Agents (`claude`, `codex`, `opencode`, `pi` are preinstalled) start as detached terminals in the machine's cmux-tui session: closing the pane does not kill them, and `cmux vm open <machine>/<ws>/<term>` reattaches from any device. Credentials for cloud agents come from `cmux ai-accounts upload`.

### Create, attach, inspect

```bash
cmux vm new --detach                # fresh persistent machine; prints id + next commands
cmux vm shell <id>                  # terminal workspace on it (managed attach)
cmux vm desktop <id>                # its noVNC screen as a browser pane
cmux vm tui <id>                    # the machine's full cmux-tui client in a pane
cmux vm base                        # the persistent Base slot
cmux vm status <id>; cmux vm stats <id>; cmux vm ports <id>; cmux vm tools <id>
```

### Preview a server running on a machine

```bash
cmux vm open <id> 3000              # private tokened URL, opened as a browser pane
cmux vm open <id> 3000 --print      # just print the URL
```

### Move files

```bash
cmux vm push <id> ./myrepo work/myrepo      # dirs travel as tarballs, node_modules/.git excluded
cmux vm pull <id> work/report.pdf
```

### Save and reproduce state

```bash
cmux vm snapshot <id> --name before-upgrade
cmux vm restore <snapshot-id>               # new machine from the snapshot
cmux vm fork <id>                           # copy of a running machine
```

## Inside a machine

The guest `cmux` binary is the machine's relay CLI. Its commands are forwarded to the **connected cmux app on the user's Mac**, not executed in the VM: `cmux notify` posts to the user's notification center, `cmux browser …` drives the Mac's browser panes, `cmux read-screen` / `send` / workspace and pane verbs act on the Mac's UI. It resolves its socket from `CMUX_SOCKET_PATH`, then `~/.cmux/socket_addr`, then the cloud CLI bridge socket; if no client is attached, relay commands fail — that is expected, not a broken install.

The one every cloud agent should know:

```bash
cmux notify --title "Build done" --subtitle "myrepo" --body "Tests green, artifact in work/dist"
```

`--workspace`/`--surface` default from `CMUX_WORKSPACE_ID`/`CMUX_SURFACE_ID` so the notification is attributed to the calling pane. Agent tool paths live under `/root/.npm-global/bin`, `/root/.bun/bin`, `/root/.local/bin`; use a login shell (`bash -lc`) when a tool is "missing".

## Rules

- MUST NOT run `cmux vm rm` on a machine you did not create in this session unless the user names it this turn. It is irreversible and unprompted. When the user wants a fresh Base, use `cmux vm base reset`, which retains the old VM.
- MUST NOT pass a name to `cmux vm new` — it takes no positional arguments (rejected to prevent accidental paid provisioning). Create, then `cmux vm rename`.
- Prefer `vm run`/`vm agent` routing over creating machines; creation counts against the plan limit and bills the user. Check `cmux vm ls` before `vm new`.
- Do not loop on `vm status` waiting for readiness; use `cmux vm wait <id> [--wake]`.
- Do not use `cmux vm ssh` unless the managed attach path failed; some providers and images cannot mint SSH, so treat "SSH unavailable" as normal, not as an error to fix. Say why in the handoff when you fall back.
- Do not call the internal attach helpers (`vm ssh-attach`, `vm-pty-attach`, `vm-ssh-attach`, `vm-pty-connect`, `vm-tui-connect`, `vm-tui-approve`).
- `vm exec` quoting is faithful per argv element; do not pre-quote. Wrap shell constructs as `-- sh -c '<script>'`.
- Provider choice belongs to the backend. Use `--provider` only for a rollback or experiment the user asked for.
- Use `--json` only on commands whose `--help` documents it; interactive verbs (`shell`, `tui`, `desktop`) have none. Do not parse the human table output either way.
- Plan limits, sizes, and providers change; read them from `cmux vm ls` and `--help` output rather than assuming values from this file.

© manaflow-ai · MIT · manaflow-ai/cmux-skills

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
cmux-cloud-vm manaflow-ai Скилл cmux-cloud-vm учит агента работать с машинами cmux Cloud: найти подходящую, запустить команду или фонового кодинг-агента, затем прочитать вывод терминала. CX Codex +1 958установок cmux-settings manaflow-ai Скилл cmux-settings читает и меняет настройки cmux в ~/.config/cmux/cmux.json: терминал, браузер, Markdown, diff, заметки и горячие клавиши. CX Codex +1 7 700установок openrig-cmux mvschwarz Скилл openrig-cmux для Claude Code открывает терминалы агентов OpenRig в тайлах cmux командой rig terminal --provider cmux. Позволяет мониторить риги и миссии. CX Codex +1 ★ 8 928звёзд репо using-cmux hummer98 Плагин using-cmux учит агента запускать субагентов в панелях cmux и следить за их работой в реальном времени, а не гадать, что происходит внутри встроенного Agent. ★ 45звёзд репо cmux-terminal-multiplexer reason-machines Скилл cmux-terminal-multiplexer организует сплиты терминала и запускает встроенный Chromium для Claude Code и других кодинг-агентов через CLI с адресацией по поверхностям. CX Codex +1 1 500установок using-medusa-cloud medusajs Скилл using-medusa-cloud для Claude Code: работа с Medusa Cloud через CLI mcloud — деплой, разбор упавших сборок, управление окружениями и переменными. CX Codex +1 1 700установок

Из того же набора8

cmux-cli Скилл cmux-cli для Claude Code подсказывает агенту синтаксис команд cmux и правила безопасной автоматизации окон, панелей и браузерных поверхностей. CX Codex +1 908установок cmux-browser Скилл cmux-browser для автоматизации встроенного браузера cmux: открывает веб-поверхности в рабочем пространстве и взаимодействует со страницами через снапшоты DOM. CX Codex +1 818установок cmux-workspace Скилл cmux-workspace держит действия агента внутри воркспейса cmux, который его вызвал: панели, поверхности, сокет, превью артефактов. CX Codex +1 813установок cmux-config Скилл cmux-config правит конфиг cmux в ~/.config/cmux/cmux.json: внешний вид, горячие клавиши, кнопки таб-бара, группы воркспейсов. Сохранение применяется сразу, без перезапуска. CX Codex +1 767установок cmux-ref Скилл cmux-ref разбирает скопированные идентификаторы сессий cmux и направляет команды агента в нужный терминал или окно. Пригодится при параллельной работе с несколькими панелями. CX Codex +1 762установок cmux-artifact Скилл cmux-artifact для Claude Code и других агентов, который собирает HTML-отчёты о проверках и открывает их рядом с рабочим терминалом. Собирает логи, скриншоты и тайминги в один файл и показывает его в браузере. CX Codex +1 708установок cmux-sidebar-builder Скилл cmux-sidebar-builder для Claude Code, который создаёт и правит кастомные сайдбары cmux через рантайм-интерпретатор в стиле SwiftUI. Файлы .swift лежат в ~/.config/cmux/sidebars/ и рендерятся на лету, без пересборки приложения. CX Codex +1 686установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой