cmux release workflow, version bumping, changelog updates, pretag guard, release tags, and release asset expectations. Use when preparing or troubleshooting a cmux release.

cmux Release Prefer the /release command. It determines the new version (minor by default), gathers commits since the last tag, updates CHANGELOG.md , runs ./scripts/bump version.sh , commits, runs ./scripts/release pretag guard.sh , then tags and pushes. The docs changelog page at web/app/[locale]/(landing)/docs/changelog/page.tsx renders from CHANGELOG.md , so there is no separate docs changelog source to update. Version bumping This updates MARKETING VERSION and CURRENT PROJECT VERSION . The build number auto increments and must increase for Sparkle auto update to work. Bump the minor version unless explicitly asked otherwise. Tagging If the pretag guard fails, run ./scripts/bump version.sh , commit the build number bump, then retry. Release artifacts and secrets The release asset is cmux macos.dmg , attached to the tag. The README download button points to releases/latest/download/cmux macos.dmg . Signing and notarization require the GitHub secrets APPLE CERTIFICATE BASE64 , APPLE CERTIFICATE PASSWORD , APPLE SIGNING IDENTITY , APPLE ID , APPLE APP SPECIFIC PASSWORD , APPLE TEAM ID . Detailed reference [references/release checklist.md](references/release checklist.md): changelog tone, failure triage, and asset rename fallout.

cmux-release