Documentation
README
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:
CMUX_TAG=<tag> scripts/cmux-debug-cli.sh list-workspaces
This is the opening of the README. Read the full README on GitHub.