cmux-architecture
cmux package architecture, refactor layering, dependency inversion, file organization, DocC documentation, package design…
@manaflow-aiInstall SkillDevelopment
Skill
/cmux-dev-workflow
Contributor workflow for native cmux setup, tagged dev builds, Xcode project normalization and sidebar extensions. Use for native build inputs, setup or tagged app verification.
Claude Code
$ npx -y skills add manaflow-ai/cmux --skill cmux-dev-workflow --agent claude-code
Codex
$ npx skills add manaflow-ai/cmux --skill cmux-dev-workflow -a codex -y
Cursor
$ npx skills add manaflow-ai/cmux --skill cmux-dev-workflow -a cursor -y
Gemini CLI
$ npx skills add manaflow-ai/cmux --skill cmux-dev-workflow -a gemini-cli -y
GitHub Copilot
$ npx skills add manaflow-ai/cmux --skill cmux-dev-workflow -a github-copilot -y
OpenCode
$ npx skills add manaflow-ai/cmux --skill cmux-dev-workflow -a opencode -y
Windsurf
$ npx skills add manaflow-ai/cmux --skill cmux-dev-workflow -a windsurf -y
SKILL.md
cmux-dev-workflow.SKILL.mdname: cmux-dev-workflow
description: "Contributor workflow for native cmux setup, tagged dev builds, Xcode project normalization and sidebar extensions. Use for native build inputs, setup or tagged app verification."
cmux Dev Workflow
Scope and routing
Run repository commands only from a [trusted checkout](../../docs/contributor-verification.md#trust-boundary); even `verify-local.py --help` and `--list` load repository code.
[Choose verification for the change](../cmux-testing/references/local-vs-ci-validation.md) before preparing a native build. Fast feedback starts with `python3 scripts/verify-local.py`; portable-tooling and documentation changes use their scoped checks without an unrelated app build.
For native app or build-input changes, build with a tag as below. Setup (`./scripts/setup.sh`) initializes submodules, builds GhosttyKit and installs the project-normalization hook; it is not a prerequisite for portable static checks.
Tagged local development
When local native execution is authorized:
./scripts/reload.sh --tag <short-tag>
CMUX_TAG=<short-tag> scripts/cmux-debug-cli.sh list-workspaces
Reload builds without launching; add `--launch` when live verification is needed. Never use bare `xcodebuild` or open an untagged `cmux DEV.app`: tags isolate bundle IDs, sockets and build output from other sessions. Do not use `/tmp/cmux-cli`, which follows the most recently reloaded app. See [tagged builds](references/tagged-builds.md). Never quit, kill, relaunch or `xctrace --launch` the user's running cmux (`com.cmuxterm.app`); it holds their live agent sessions.
An app build does not establish test-target compilation or execution. Follow [the test guide](../cmux-testing/references/local-vs-ci-validation.md) for those claims.
Toolchain and project files
`.xcode-version` owns the Xcode major; `cmux.xcodeproj/project.pbxproj` currently uses objectVersion 60. The Intel/macOS 14 fallback uses Xcode 16.2/Swift 6.0; keep app-linked code compatible as specified in [Swift 6.0 compatibility](../cmux-architecture/references/swift-6-0-compatibility.md).
The installed pre-commit hook normalizes staged project files and registers new Python tests in `tests/test-execution.toml`. Preserve it and run `python3 scripts/verify-local.py --only project` after project edits. Toolchain pin changes are deliberate team decisions; see [project normalization](references/xcode-project-normalization.md).
Sidebar extension tags
Keep the extension-point ID, bundle-ID suffix and display-name suffix distinct for each tag. Build extensions through `scripts/reload-extension.sh --tag <tag>` with the matching host; do not repair a mismatched tag by re-signing. The exact settings, helper arguments and verification checklist live in [sidebar extension tagging](references/sidebar-extension-tagging.md).
Read more
name: cmux-dev-workflow description: "Contributor workflow for native cmux setup, tagged dev builds, Xcode project normalization and sidebar extensions. Use for native build inputs, setup or tagged app verification."
cmux Dev Workflow
Scope and routing
Run repository commands only from a [trusted checkout](../../docs/contributor-verification.md#trust-boundary); even `verify-local.py --help` and `--list` load repository code.
[Choose verification for the change](../cmux-testing/references/local-vs-ci-validation.md) before preparing a native build. Fast feedback starts with `python3 scripts/verify-local.py`; portable-tooling and documentation changes use their scoped checks without an unrelated app build.
For native app or build-input changes, build with a tag as below. Setup (`./scripts/setup.sh`) initializes submodules, builds GhosttyKit and installs the project-normalization hook; it is not a prerequisite for portable static checks.
Tagged local development
When local native execution is authorized:
./scripts/reload.sh --tag <short-tag> CMUX_TAG=<short-tag> scripts/cmux-debug-cli.sh list-workspaces
Reload builds without launching; add `--launch` when live verification is needed. Never use bare `xcodebuild` or open an untagged `cmux DEV.app`: tags isolate bundle IDs, sockets and build output from other sessions. Do not use `/tmp/cmux-cli`, which follows the most recently reloaded app. See [tagged builds](references/tagged-builds.md). Never quit, kill, relaunch or `xctrace --launch` the user's running cmux (`com.cmuxterm.app`); it holds their live agent sessions.
An app build does not establish test-target compilation or execution. Follow [the test guide](../cmux-testing/references/local-vs-ci-validation.md) for those claims.
Toolchain and project files
`.xcode-version` owns the Xcode major; `cmux.xcodeproj/project.pbxproj` currently uses objectVersion 60. The Intel/macOS 14 fallback uses Xcode 16.2/Swift 6.0; keep app-linked code compatible as specified in [Swift 6.0 compatibility](../cmux-architecture/references/swift-6-0-compatibility.md).
The installed pre-commit hook normalizes staged project files and registers new Python tests in `tests/test-execution.toml`. Preserve it and run `python3 scripts/verify-local.py --only project` after project edits. Toolchain pin changes are deliberate team decisions; see [project normalization](references/xcode-project-normalization.md).
Sidebar extension tags
Keep the extension-point ID, bundle-ID suffix and display-name suffix distinct for each tag. Build extensions through `scripts/reload-extension.sh --tag <tag>` with the matching host; do not repair a mismatched tag by re-signing. The exact settings, helper arguments and verification checklist live in [sidebar extension tagging](references/sidebar-extension-tagging.md).
Ships withcmux
Open source Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. Built for multitasking, organization, and programmability.
29k25 skills
Stars on GitHub
Momentum
- stars in total
- 28.8k
Other skills on cmux.
@manaflow-aiInstall Skillcmux-backend
Backend TypeScript and Cloud VM development rules for cmux. Use when editing web/app/api, web/services, backend scripts, Cloud VM…
@manaflow-aiInstall Skillcmux-billing
Stripe checkout, pricing, subscription, Pro plan, webhook, and entitlement runbook for cmux billing work. Use when editing or…
@manaflow-aiInstall Skillcmux-browser
End-user browser automation with cmux. Use when you need to open sites, inspect or interact with browser surfaces, wait for page…
@manaflow-aiInstall Skillcmux-capture
Screenshot or record a cmux window from the CLI, for a pull request, a bug report, or to see what the app actually looks like…
@manaflow-aiInstall Skillcmux-cloud-vm
Operate cmux Cloud machines, run durable remote commands or agents, and present their workspaces or services. Use for cmux…
@manaflow-aiInstall SkillMore skills from other plugins.
Auto-invoked
brainstorming
You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…
@obraInstall Skillask-matt
Ask which skill or flow fits your situation. A router over the skills in this repo.
@mattpocockInstall SkillAuto-invoked
Questions about cmux-dev-workflow.
- Which coding agents can use cmux-dev-workflow?
- cmux-dev-workflow installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.