cmux Dev Workflow

Tagged local dev

After making code changes, always run the reload script with a tag to build the Debug app:

./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.

For CLI or socket dogfood against a tagged Debug app, use the tag-bound helper and set CMUX_TAG:

CMUX_TAG=<tag> scripts/cmux-debug-cli.sh list-workspaces