Codewhale Fleet Manager
codewhale-hq/Codewhale
Triages and manages Codewhale fleet runs and workers with typed commands, classifying failures and choosing a safe restart, resume or escalation.
Operates cmux Cloud machines from the cmux CLI, running durable remote commands or detached agents and presenting their workspaces, with authorization limits on destructive steps.
Install cmux Cloud Machines
$ npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install manaflow-ai/cmux cmux-cloud-vm --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/cmux-cloud-vm .claude/skills/cmux-cloud-vm && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "cmux-cloud-vm" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-cloud-vm into .claude/skills/cmux-cloud-vm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-cloud-vm", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-cloud-vmType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install manaflow-ai/cmux cmux-cloud-vm --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/cmux-cloud-vm .agents/skills/cmux-cloud-vm && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "cmux-cloud-vm" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-cloud-vm into .agents/skills/cmux-cloud-vm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-cloud-vm", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install manaflow-ai/cmux cmux-cloud-vm --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/cmux-cloud-vm .cursor/skills/cmux-cloud-vm && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "cmux-cloud-vm" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-cloud-vm into .cursor/skills/cmux-cloud-vm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-cloud-vm", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/manaflow-ai/cmux.git --path skills/cmux-cloud-vm--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install manaflow-ai/cmux cmux-cloud-vm --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/cmux-cloud-vm .gemini/skills/cmux-cloud-vm && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "cmux-cloud-vm" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-cloud-vm into .gemini/skills/cmux-cloud-vm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-cloud-vm", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install manaflow-ai/cmux cmux-cloud-vmInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/cmux-cloud-vm .github/skills/cmux-cloud-vm && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "cmux-cloud-vm" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-cloud-vm into .github/skills/cmux-cloud-vm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-cloud-vm", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install manaflow-ai/cmux cmux-cloud-vm --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/manaflow-ai/cmux.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/cmux-cloud-vm .opencode/skills/cmux-cloud-vm && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "cmux-cloud-vm" agent skill from https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-cloud-vm into .opencode/skills/cmux-cloud-vm/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "cmux-cloud-vm", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
cmux-cloud-vm- GitHub stars
- 28k
- Token cost
- ~864 tokens
- SKILL.md length
- 422 words
- Files
- 6 (incl. references)
- Skills in repo
- 22
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Operates cmux Cloud machines from the cmux CLI, running durable remote commands or detached agents and presenting their workspaces, with authorization limits on destructive steps.
- Running a long command or test on a cmux Cloud machine that must survive disconnects
- SKILL.md covers Start with discovery, Run and observe, Constraints that apply… and Read only the relevant detail
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Starting a detached coding agent on a remote machine
What it does
Work happens on an existing cmux Cloud machine and workspace. Machine terminals persist when panes close or the Mac disconnects, so the agent works headlessly and opens a pane or shares a URL only when there is a result to inspect. It starts with discovery commands (cmux vm --help, cmux auth status, cmux vm ls --json), and uses cmux route to inspect placement without creating a machine, reading its would_provision, limits and capabilities rather than assuming plan caps.
A table picks the operation: cmux vm run for a bounded command with an exit code, cmux vm agent for a detached coding agent, cmux vm dev with --dry-run for a project with a dev layout, vm tree and terminal read to observe, and terminal wait-exit then output for completion. A finished wait is not proof that tests passed, so the agent reports the real exit result. Provisioning, forking, resetting, resizing and destructive cleanup need your authorization, tokens stay on the host, and credentials are not copied into a machine unless you ask.
When your agent uses it
- Running a long command or test on a cmux Cloud machine that must survive disconnects
- Starting a detached coding agent on a remote machine
- Checking what a cmux Cloud machine is running without opening panes
- Showing a verified remote result to the user in a pane or by URL
Example prompts
- “List my cmux Cloud machines and show what is running on each.”
- “Run the integration test suite on my existing cmux machine and report the real exit code.”
- “Start a detached Codex agent on the dev machine to fix the failing lint step.”
Requirements
- The cmux app on a Mac, signed in
- The cmux CLI with access to cmux Cloud
- Your authorization for provisioning or destructive actions
What it can do on your machine
Read from SKILL.md and the folder at commit f6532b1. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
cmux Cloud Machines loads about 864 tokens when it runs, and up to ~27k if it reads all its reference files. Until then it costs about 50 tokens; SKILL.md has 422 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 422 words (~864 tokens).
“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.”
- name
- cmux-cloud-vm
Files
SKILL.md and 5 other files (references) in skills/cmux-cloud-vm of manaflow-ai/cmux.
- SKILL.md
- agents/openai.yaml
- references/agent-workflows.md
- references/commands.md
- references/guest.md
- references/sidebar-parity.md
Open the folder on GitHubat commit f6532b1
Compare with similar skills
cmux Cloud Machines next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| cmux Cloud Machines this skillmanaflow-ai/cmux | 28k | — | ~864 | Automated safety check: Pass | Custom licence | |
| Codewhale Fleet Managercodewhale-hq/Codewhale | 41k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Jarvis Setupethanplusai/jarvis | 843 | — | ~2.5k | Automated safety check: Notes | Custom licence | |
| Fleet Manager for Agent Sessionsasgeirtj/system_prompts_leaks | 69k | — | ~2.5k | Automated safety check: Pass | CC0-1.0 | |
| Adk Agent Buildergoogle/adk-python | 22k | — | ~879 | Automated safety check: Pass | Apache-2.0 | |
| Smithers Durable Flow Driversmithersai/smithers | 430 | — | ~3k | Automated safety check: Pass | MIT |
Similar skills
Jarvis Setup
ethanplusai/jarvis
A skill your agent uses when helping someone install, configure, or debug a fresh clone of JARVIS (this repo) — especially "the mic doesn't work", "JARVIS says his language systems are down", any…
Fleet Manager for Agent Sessions
asgeirtj/system_prompts_leaks
Shows one digest of coding-agent sessions across your connected machines and lets you open, read, steer, approve, stop and close them, over Herdr, tmux or MSP.
- Official
Adk Agent Builder
google/adk-python
Builds ADK (Agent Development Kit) Python agents: LLM agents with tools, graph workflows of function and agent nodes, conditional routing, fan-out and join, schema-validated delegation between…
Smithers Durable Flow Driver
smithersai/smithers
Runs or authors Smithers TypeScript flows for ordered agent stages with retries, approvals, bounded loops and crash-safe recovery, built from Flow.make, Action.make and Effect.
Dutis macOS Handler Manager
tsonglew/dutis
Inspects, plans, changes and rolls back macOS default app handlers for file types, MIME types and URL schemes through Dutis, with approval before any write.
More from manaflow-ai/cmux
All 22 skills in this repocmux Diagnostics
manaflow-ai/cmux
Runs a read-only health check for cmux and explains what it finds, covering the CLI and socket, settings, agent hooks, session restore and notifications.
cmux Settings Editor
manaflow-ai/cmux
Reads and changes cmux preferences in `~/.config/cmux/cmux.json` through a helper that validates each change before writing, covering terminal, browser, viewers and shortcuts.
cmux Backend Rules
manaflow-ai/cmux
Sets the backend TypeScript and Cloud VM rules for cmux: Effect-based services, thin route handlers, Postgres as source of truth, migrations and provider secrets.
Cmux Debugging Guide
manaflow-ai/cmux
Covers debug logging, the Debug menu, profiling rules and runtime pitfalls for working on the cmux macOS terminal app.
Ghostty Submodule and GhosttyKit Workflow
manaflow-ai/cmux
Workflow rules for the Ghostty submodule in cmux: rebuilding GhosttyKit.xcframework, pushing fork changes and updating the parent submodule pointer safely.
Cmux Release Workflow
manaflow-ai/cmux
Runs the cmux release process: gathers per-PR changelog lines since the last tag, bumps the version, guards against a bad tag, then tags and pushes the macOS DMG release.
Related
Works with
Categories
Questions about cmux Cloud Machines
What does cmux Cloud Machines do?
Operates cmux Cloud machines from the cmux CLI, running durable remote commands or detached agents and presenting their workspaces, with authorization limits on destructive steps. Work happens on an existing cmux Cloud machine and workspace. Machine terminals persist when panes close or the Mac disconnects, so the agent works headlessly and opens a pane or shares a URL only when there is a result to inspect.
When should I use cmux Cloud Machines?
cmux Cloud Machines fits situations like: running a long command or test on a cmux Cloud machine that must survive disconnects; starting a detached coding agent on a remote machine; checking what a cmux Cloud machine is running without opening panes; showing a verified remote result to the user in a pane or by URL.
How do I install cmux Cloud Machines in Claude Code?
Run `npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -a claude-code`. Or copy the skill folder (skills/cmux-cloud-vm in manaflow-ai/cmux) into .claude/skills/cmux-cloud-vm in your project. Claude Code loads it when a task matches its description.
How do I install cmux Cloud Machines in Codex?
Run `npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -a codex`. Or copy the skill folder (skills/cmux-cloud-vm in manaflow-ai/cmux) into .agents/skills/cmux-cloud-vm in your project. Codex loads it when a task matches its description.
Can I use cmux Cloud Machines in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add manaflow-ai/cmux --skill cmux-cloud-vm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cmux-cloud-vm, .gemini/skills/cmux-cloud-vm, .github/skills/cmux-cloud-vm and .opencode/skills/cmux-cloud-vm in your project.
What does cmux Cloud Machines need to run?
SKILL.md names no scripts, command-line tools or credentials: cmux Cloud Machines is instructions for the agent only. Our summary lists: The cmux app on a Mac, signed in; The cmux CLI with access to cmux Cloud; Your authorization for provisioning or destructive actions.
Does cmux Cloud Machines access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is cmux Cloud Machines safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does cmux Cloud Machines use?
cmux Cloud Machines has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does cmux Cloud Machines use?
About 864 tokens (SKILL.md is roughly 3.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 26k tokens, read only when the agent opens those files.
What are the alternatives to cmux Cloud Machines?
Skills that share tags, products or a category with cmux Cloud Machines: Codewhale Fleet Manager (codewhale-hq/Codewhale, 41k stars), Jarvis Setup (ethanplusai/jarvis, 843 stars), Fleet Manager for Agent Sessions (asgeirtj/system_prompts_leaks, 69k stars) and Adk Agent Builder (google/adk-python, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains cmux Cloud Machines?
manaflow-ai (a GitHub organization) maintains it in manaflow-ai/cmux, which has 28,044 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on October 9, 2026.
Source: manaflow-ai/cmux on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.