cmux-release

Source excerpt starting at line 1.

1---2name: cmux-release3description: "cmux release workflow, version bumping, changelog updates, pretag guard, release tags, and release asset expectations. Use when preparing or troubleshooting a cmux release."4---5 6# cmux Release7 8Prefer 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.9 10The 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.11 12## Version bumping13 14```bash15./scripts/bump-version.sh          # minor (0.15.0 -> 0.16.0)16./scripts/bump-version.sh patch    # 0.15.0 -> 0.15.117./scripts/bump-version.sh major    # 0.15.0 -> 1.0.018./scripts/bump-version.sh 1.0.0    # explicit version19```20 21This 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.22 23## Tagging24 25```bash26./scripts/release-pretag-guard.sh27git tag vX.Y.Z28git push origin vX.Y.Z29gh run watch --repo manaflow-ai/cmux30```31 32If the pretag guard fails, run `./scripts/bump-version.sh`, commit the build-number bump, then retry.33 34## Release artifacts and secrets35 36- The release asset is `cmux-macos.dmg`, attached to the tag. The README download button points to `releases/latest/download/cmux-macos.dmg`.37- 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`.38 39## Detailed reference40 41- [references/release-checklist.md](references/release-checklist.md): changelog tone, failure triage, and asset-rename fallout.42