Skip to main content
affpapa.org
RU EN
skill CX Codex

cmux-dev-workflow — Claude Code skill: use and install

This skill guides native cmux work, from repository setup to tagged app builds and sidebar extension checks. Use it when changing native build inputs.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add manaflow-ai/cmux --skill cmux-dev-workflow -a claude-code
Open on GitHub

What cmux-dev-workflow does

The skill lays out a workflow for native cmux changes. It routes contributors to the relevant local or CI validation, with python3 scripts/verify-local.py as the starting check. App and build-input work uses tagged commands such as ./scripts/reload.sh --tag <short-tag> and CMUX_TAG=<short-tag> scripts/cmux-debug-cli.sh list-workspaces.

Running ./scripts/setup.sh prepares submodules, compiles GhosttyKit, and adds the project-normalization hook. After Xcode project edits, run python3 scripts/verify-local.py --only project; the hook also records new Python tests in the test configuration. Sidebar extensions use scripts/reload-extension.sh --tag <tag> together with the corresponding host.

Tags keep bundle IDs, sockets, and build output apart across sessions. A plain xcodebuild invocation and an untagged cmux DEV.app are disallowed, and the user’s active cmux process must not be stopped or restarted.

What it helps with

  • prepare a tagged native cmux build
  • validate edits to the Xcode project
  • build a sidebar extension with its matching host
  • register new Python tests
  • separate outputs from concurrent dev sessions

Example prompts for the agent

  • Prepare a tagged native cmux build with ./scripts/reload.sh --tag <short-tag>.
  • Review cmux.xcodeproj/project.pbxproj changes and choose the matching local validation.
  • Build the sidebar extension with scripts/reload-extension.sh --tag <tag> and check its matching host.

How to install cmux-dev-workflow

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/cmux-dev-workflow/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cmux-dev-workflow/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about cmux-dev-workflow

How do I install cmux-dev-workflow in Claude Code?

Run npx skills add manaflow-ai/cmux --skill cmux-dev-workflow -a claude-code, then check ~/.claude/skills/cmux-dev-workflow/SKILL.md.

What does cmux-dev-workflow do?

It defines a contributor workflow for native cmux work, covering local checks, tagged app builds, Xcode project normalization, and sidebar extension builds.

Why does the cmux workflow require tags?

Tags keep bundle IDs, sockets, and build products separated between sessions. The workflow rejects an untagged cmux DEV.app, and the active user cmux process must not be restarted or terminated.

Similar skills

Everything for DevOps and infrastructure →
wizard Matt Pocock This skill creates an interactive bash wizard for manual setup steps, CI secrets, third-party dashboards, and one-off migrations. 553,369installs hyperframes-cli heygen-com Controls HyperFrames video workflows from the CLI: audits layouts and contrast, edits timeline clips, captures snapshots, and renders locally or in cloud runtimes. CX Codex +1 1,300,000installs setup-pre-commit Matt Pocock This skill configures pre-commit checks for a JavaScript repository, running Prettier, type checking, and tests before each commit. 489,289installs using-git-worktrees Jesse Vincent Prepares an isolated workspace before feature work or plan execution. It checks the repository first, then uses native worktree support or Git. CX Codex 217,153installs finishing-a-development-branch Jesse Vincent This skill checks the test suite and guides branch completion: merge locally, open a Pull Request, or leave the work in place. CX Codex 214,439installs orca-cli stablyai The skill lets an agent manage Orca worktrees, terminals, artifacts and the built-in browser through the orca CLI. Useful when your work already runs inside Orca. CX Codex +1 353,600installs

From the same set24

The whole set →
cmux-workspace Keeps an agent's actions inside the cmux workspace and terminal that started it, so automation does not disturb whatever the user is looking at. CX Codex +1 6,900installs cmux-customization Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty. CX Codex +1 6,700installs cmux-diagnostics Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report. CX Codex +1 6,400installs cmux-keyboard-shortcuts Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. CX Codex +1 6,200installs cmux-testing Skill for choosing verification scopes, adding tests, and validating Swift test targets in the cmux project. Decides what local and CI evidence a change needs. CX Codex +1 4,900installs cmux-custom-sidebar Skill for writing a custom cmux sidebar in a SwiftUI-like language. The sidebar binds to workspaces, tabs, PRs, and clock; hot-reloads on save; runs cmux commands on tap. CX Codex +1 4,800installs cmux-architecture Guides modular Swift package architecture, strict 5-layer dependency inversion, and Swift 6 concurrency rules in the cmux codebase. CX Codex +1 4,900installs cmux-ghostty Enforces workflow guidelines for the Ghostty submodule and GhosttyKit compilation in cmux. Useful when syncing the fork or committing submodule pointers. CX Codex +1 4,700installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor