How do I install the Cmux Release skill?

Run npx skillmds add om-scogo/cmux-release in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cmux Release safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cmux Release?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cmux Release free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cmux Release?

om-scogo (@om-scogo) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cmux Release by om-scogo — Agent Skill

Name: Cmux Release
Rating: 4.2 (5 reviews)
Author: om-scogo

File contents

cmux Release

Use the /release command to prepare a new release. This will:

Determine the new version (bumps minor by default)
Gather commits since the last tag and update the changelog
Update CHANGELOG.md (the docs changelog page at web/app/docs/changelog/page.tsx reads from it)
Run ./scripts/bump-version.sh to update both versions
Commit, run ./scripts/release-pretag-guard.sh, tag, and push

Version bumping

./scripts/bump-version.sh
./scripts/bump-version.sh patch
./scripts/bump-version.sh major
./scripts/bump-version.sh 1.0.0

This updates both MARKETING_VERSION and CURRENT_PROJECT_VERSION. The build number is auto-incremented and is required for Sparkle auto-update to work.

Before creating a release tag, run:

./scripts/release-pretag-guard.sh

If it fails, run ./scripts/bump-version.sh, commit the build-number bump, then retry tagging.

Manual release steps if not using the command:

./scripts/release-pretag-guard.sh
git tag vX.Y.Z
git push origin vX.Y.Z
gh run watch --repo manaflow-ai/cmux

Notes

Requires GitHub secrets: APPLE_CERTIFICATE_BASE64, APPLE_CERTIFICATE_PASSWORD, APPLE_SIGNING_IDENTITY, APPLE_ID, APPLE_APP_SPECIFIC_PASSWORD, APPLE_TEAM_ID.
The release asset is cmux-macos.dmg attached to the tag.
README download button points to releases/latest/download/cmux-macos.dmg.
Bump the minor version for updates unless explicitly asked otherwise.
Update CHANGELOG.md; docs changelog is rendered from it.

Detailed reference

Read references/release-checklist.md for a more detailed release checklist and common failure handling.

---name: cmux-releasedescription: 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 Use the `/release` command to prepare a new release. This will: 1. Determine the new version (bumps minor by default) 2. Gather commits since the last tag and update the changelog 3. Update `CHANGELOG.md` (the docs changelog page at `web/app/docs/changelog/page.tsx` reads from it) 4. Run `./scripts/bump-version.sh` to update both versions 5. Commit, run `./scripts/release-pretag-guard.sh`, tag, and push ## Version bumping ```bash ./scripts/bump-version.sh ./scripts/bump-version.sh patch ./scripts/bump-version.sh major ./scripts/bump-version.sh 1.0.0 ``` This updates both `MARKETING_VERSION` and `CURRENT_PROJECT_VERSION`. The build number is auto-incremented and is required for Sparkle auto-update to work. Before creating a release tag, run: ```bash ./scripts/release-pretag-guard.sh ``` If it fails, run `./scripts/bump-version.sh`, commit the build-number bump, then retry tagging. Manual release steps if not using the command: ```bash ./scripts/release-pretag-guard.sh git tag vX.Y.Z git push origin vX.Y.Z gh run watch --repo manaflow-ai/cmux ``` ## Notes - Requires GitHub secrets: `APPLE_CERTIFICATE_BASE64`, `APPLE_CERTIFICATE_PASSWORD`, `APPLE_SIGNING_IDENTITY`, `APPLE_ID`, `APPLE_APP_SPECIFIC_PASSWORD`, `APPLE_TEAM_ID`. - The release asset is `cmux-macos.dmg` attached to the tag. - README download button points to `releases/latest/download/cmux-macos.dmg`. - Bump the minor version for updates unless explicitly asked otherwise. - Update `CHANGELOG.md`; docs changelog is rendered from it. ## Detailed reference - Read [references/release-checklist.md](references/release-checklist.md) for a more detailed release checklist and common failure handling.

Frequently asked questions