cmux Dev Workflow

Initial setup

./scripts/setup.sh initializes submodules, builds GhosttyKit, and installs the pbxproj normalization pre-commit hook.

Tagged local dev

Build the Debug app after every code change:

./scripts/reload.sh --tag <short-tag>

It builds without launching; pass --launch only when you need the app open. 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: