cmux-release

Automate cmux release version bumps, changelog updates, and tag creation.

25.8k|2.2k|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/manaflow-ai/cmux --skill cmux-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cmux-release
Source: https://github.com/manaflow-ai/cmux/tree/main/skills/cmux-release
Command: npx skills add https://github.com/manaflow-ai/cmux --skill cmux-release

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

cmux Release automates the release workflow to streamline version bumps, changelog updates, tagging, and asset validation, reducing manual toil and human error.

Core Features & Use Cases

  • Automated version bumps: updates both MARKETING_VERSION and CURRENT_PROJECT_VERSION, ensuring consistent release metadata.
  • Changelog synchronization: gathers commits since the last tag and updates CHANGELOG.md, which is surfaced by the docs page.
  • Tagging & asset checks: creates release tags, runs pretag guards, and verifies release assets like cmux-macos.dmg before publishing.
  • Guided/manual fallback: provides explicit steps for teams to follow if automation is not used.

Quick Start

Run the /release command to prepare and publish a new cmux release.

Frequently Asked Questions about cmux-release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate version bumps and changelog updates for a release?

Automated release management updates both MARKETING_VERSION and CURRENT_PROJECT_VERSION, gathers commits since the last tag to update CHANGELOG.md, and creates release tags.

What is the best way to validate build assets and enforce build-number monotonicity before publishing?

Release management runs pretag guards to enforce build-number monotonicity and verifies release assets like cmux-macos.dmg before publishing to ensure valid builds.

How do I prepare a new release and publish it from start to finish?

Run the /release command to prepare and publish a new release, which automates the entire workflow including version bumps, changelog synchronization, and asset validation.

Can I manually prepare a release if the automation is not used or fails?

Yes, guided manual fallback provides explicit steps for teams to follow for version bumping, changelog updates, and tagging if automation is not used.

Why does my release workflow fail during tagging in CI environments?

Release failures in CI environments often occur when pretag guards detect non-monotonic build numbers or when release assets like cmux-macos.dmg fail validation checks.

Does the release workflow apply to both local and CI environments?

Yes, release management validates build assets and runs version bump scripts across both local and CI environments to ensure consistent release metadata and tagging.