
Cmux Release
Cmux release workflow, version bumping, changelog updates, pretag guard, release tags...
Install
npx skills add manaflow-ai/cmux --skill cmux-release -g -a claude-code -y- Repository
- manaflow-ai/cmux28.6k
- Category
- Git and review
- Updated
- 3d ago
- License
- See repository
- Context cost
- Lightabout 949 tokens
- Runs scripts
- No, instructions only
What it does
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 the Changelog line from each PR merged since the last stable tag, updates CHANGELOG.md, runs ./scripts/bump-version.sh, commits, runs ./scripts/release-pretag-guard.sh, then tags and pushes.
Changelog source
Feature PRs don't edit CHANGELOG.md. Each PR description has a ## Changelog section with one user-facing line (Added, Changed, Fixed, or Removed, present tense) or none. At release time, /release step 2 fetches every PR merged since the last v* tag in one GraphQL query and classifies it with references/changelog-lines.jq:
- a Changelog line becomes an entry, with the PR link and
-- thanks @user!for authors and reporters outside the core team (lawrencecchen,austinywang,teamleaderleo) and bots; noneis skipped, and so is a PR undone by a revert later in the range (a reapply leaves it live);- a revert of a PR that shipped in an earlier release gets its own line and is flagged for the human; reverts within the range are skipped;
- a PR with no section, or a line without an
Added/Changed/Fixed/Removedprefix, is listed for the human to check.
The release then folds any leftover ## Unreleased entries into the new version section and removes that heading.
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
./scripts/bump-version.sh # minor (0.15.0 -> 0.16.0)
./scripts/bump-version.sh patch # 0.15.0 -> 0.15.1
./scripts/bump-version.sh major # 0.15.0 -> 1.0.0
./scripts/bump-version.sh 1.0.0 # explicit version

