Individual skill
cmux-dev-workflow
Contributor workflow rules for cmux setup, Xcode project normalization, tagged sidebar ExtensionKit development, and dev builds. Use when setting up the cmux repo, changing Xcode project files, adding sidebar extensions, or working with tagged debug builds.
ai_docs/cmux-skills/cmux-dev-workflow/SKILL.md
Source commit 6eaacabbee4c71120f7cd161c9539530f84068a8
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Instructions only
- Last checked
- Nov 11, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 116
- Repository last updated
- Jun 29, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- operations Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 6,003 bytesSKILL.mdcore · 6,003 bytesSKILL.mdcore · 6,003 bytesSKILL.mdcore · 6,003 bytesSKILL.mdcore · 6,003 bytesSKILL.mdcore · 6,003 bytesSKILL.mdcore · 6,003 bytesagents/openai.yamlasset · 330 bytesreferences/sidebar-extension-tagging.mddoc · 2,117 bytesreferences/tagged-builds.mddoc · 1,788 bytesreferences/xcode-project-normalization.mddoc · 1,207 bytes
Read excerpt
# cmux Dev Workflow
## Tagged local dev
After making code changes, always run the reload script with a tag to build the Debug app:
```bash
./scripts/reload.sh --tag <short-tag>
```
By default, `reload.sh` builds but does not launch the app. Pass `--launch` only when you need to open it automatically.
Never run bare `xcodebuild` or open an untagged `cmux DEV.app`. Untagged builds share the default debug socket and bundle ID with other agents, causing conflicts and stealing focus.