cmux-dev-workflow
/cmux-dev-workflow
Contributor workflow for native cmux setup, tagged dev builds and Xcode project normalization. Use for native build inputs, setup or tagged app verification.
- Author
- legotec73 ↗
- Repository
- CMUX ↗
- Licence
- GPL-3.0
- Last repository change
- 03.10.2026
Assessment and security
- Files in this package
- 4
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 03.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 and Xcode project normalization. Use for native build inputs, setup or tagged app verification.
Original author description
Contributor workflow for native cmux setup, tagged dev builds and Xcode project normalization. Use for native build inputs, setup or tagged app verification.
How it works
- Scope and routing
- Tagged local development
- Toolchain and project files
SKILL.md preview
--- name: cmux-dev-workflow description: "Contributor workflow for native cmux setup, tagged dev builds and Xcode project normalization. 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).
Files in this package (4)
- SKILL.md 2 KB
- agents/openai.yaml 1 KB
- references/tagged-builds.md 4 KB
- references/xcode-project-normalization.md 1 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · legotec73/CMUX | 95 | GPL-3.0 |
| manaflow-ai/cmux | 95 | GPL-3.0 |
Database snapshot: 13.11.2026 · package version bd616264bfb7 (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
- 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. - 100cmux-release
cmux release workflow, version bumping, changelog updates, pretag guard, release tags, and release asset expectations. Use when preparing or troubleshooting a cmux release. - 80cmux Workspace Orchestration
This skill should be used when the user asks to "set up a dev environment", "create a workspace", "open a browser pane", "split terminal", "spin up frontend and backend", "use cmux", "manage cmux panes", "run commands in cmux", or mentions cmux workspaces, panes, surfaces, or… - 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. - 100worktree-cmux-workspace
Use when the user wants to open the git worktree they're working on in a NEW cmux workspace (e.g. "이 worktree cmux 새 workspace로 띄워줘", "open the worktree in a new cmux workspace"). For a split pane in the current workspace instead, use worktree-cmux-split.