cmux-dev-workflow
/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.
- Author
- manaflow-ai ↗
- Repository
- cmux ↗
- Licence
- GPL-3.0
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 5
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
GPL-3.0, otwarta.
What it does and when to use it
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.
Original author 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.
How it works
- Scope and routing
- Tagged local development
- Toolchain and project files
- Sidebar extension tags
SKILL.md preview
--- 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: ```sh ./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).
Files in this package (5)
- SKILL.md 3 KB
- agents/openai.yaml 1 KB
- references/sidebar-extension-tagging.md 2 KB
- references/tagged-builds.md 4 KB
- references/xcode-project-normalization.md 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · manaflow-ai/cmux | 95 | GPL-3.0 |
| legotec73/CMUX | 95 | GPL-3.0 |
Identical content appears in 1 other GitHub folders. We show one copy with the highest score.
Database snapshot: 13.11.2026 · package version 9f59c3aeee55 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100cmux-sidebar-builder
Build, inspect, or revise cmux custom sidebar views using the runtime SwiftUI-style interpreter. Use for sidebar vibe coding, custom sidebars in Bonsplit panes, left sidebar picker previews, interpreted Swift sidebars, ~/.config/cmux/sidebars/*.swift, cmux docs sidebars, or… - 100cmux-custom-sidebar
Build a custom cmux sidebar from a plain-language request. Use when the user asks for a custom sidebar, a sidebar that shows their workspaces/tabs/PRs/clock, a vibe-coded sidebar, or anything involving files in ~/.config/cmux/sidebars/. Covers authoring the interpreted… - 90cmux-testing
Choose scoped cmux verification, add behavioral tests, and validate Swift test targets and wiring. Use when adding tests or deciding what local/CI evidence a change needs. - 90cmux-next-feature
Lawrence's standing rules for every cmux-next feature, design or agent task. Use whenever you add or change any user-facing feature, action, setting, pane, sidebar item, daemon/store op, backend op, app/extension API, or agent capability in cmux-next (Swift app, Rust… - 90cmux-testing
Choose scoped cmux verification, add behavioral tests, and validate Swift test targets and wiring. Use when adding tests or deciding what local/CI evidence a change needs. - 90cmux-testing
Choose scoped cmux verification, add behavioral tests, and validate Swift test targets and wiring. Use when adding tests or deciding what local/CI evidence a change needs.