Skip to main content
skill Claude Code CX Codex Cursor GitHub Copilot

cmux-release — Claude Code skill: what it does, how to install

Automates the cmux release pipeline by extracting changelog lines from pull requests, bumping versions, and running safety checks.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add manaflow-ai/cmux --skill cmux-release -a claude-code
Open on GitHub

What cmux-release does

This skill guides the release workflow inside the cmux repository. It inspects pull requests merged since the previous stable release tag via GraphQL, formats CHANGELOG.md with contributor credits, and cleans up unreleased sections. The workflow defaults to bumping a minor version when executing /release.

Version bumps and safety checks depend on local shell scripts. The assistant invokes ./scripts/bump-version.sh to update project version constants and auto-increment the build number required by Sparkle updates. Before git tags get pushed, ./scripts/release-pretag-guard.sh validates the repository state. If that guard check fails, you must run the bump script again and commit the new build number before retrying.

The skill targets macOS application releases specifically, expecting signing secrets like APPLE_CERTIFICATE_BASE64 and App Store Connect API keys in CI. It will fail if those scripts are absent.

What it helps with

  • extract release notes from merged pull requests
  • bump marketing version and build numbers via bash scripts
  • verify repository consistency with pretag guard before tagging
  • monitor the release run ID without polling GitHub API

Example prompts for the agent

  • Run the /release command to prepare a minor release and update CHANGELOG.md
  • Check if release-pretag-guard passes and push the new version tag
  • Bump the patch version using bump-version.sh and commit the build number

How to install cmux-release

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-release -a claude-code

2Manually: put the files in place

~/.claude/skills/cmux-release/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cmux-release/

From the same set12

The whole set →
cmux manaflow-ai Skill for navigating multi-pane cmux layouts: create windows, workspaces, splits, focus surfaces, and move terminals and browser panels without breaking automation. Use it when an agent needs deterministic placement and routing. Claude Code CX Codex Cursor +1 9,600installs cmux-browser manaflow-ai Automates browser surfaces via the cmux CLI without stealing user focus. Useful for background page inspections, waiting on selectors, and form fills. Claude Code CX Codex Cursor +1 8,800installs cmux-customization manaflow-ai Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty. Claude Code CX Codex Cursor +1 6,600installs cmux-diagnostics manaflow-ai Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report. Claude Code CX Codex Cursor +1 6,400installs cmux-keyboard-shortcuts manaflow-ai Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. Claude Code CX Codex Cursor +1 6,200installs cmux-testing manaflow-ai Skill for choosing verification scopes, adding tests, and validating Swift test targets in the cmux project. Decides what local and CI evidence a change needs. Claude Code CX Codex Cursor +1 4,900installs cmux-custom-sidebar manaflow-ai Skill for writing a custom cmux sidebar in a SwiftUI-like language. The sidebar binds to workspaces, tabs, PRs, and clock; hot-reloads on save; runs cmux commands on tap. Claude Code CX Codex Cursor +1 4,800installs cmux-architecture manaflow-ai Guides modular Swift package architecture, strict 5-layer dependency inversion, and Swift 6 concurrency rules in the cmux codebase. Claude Code CX Codex Cursor +1 4,800installs

Similar

changelog-automation Seth Hobson This skill helps generate changelogs and release notes from commits, PRs, and releases. Use it when setting up release workflows or shared commit rules. Claude Code CX Codex Cursor 13,733installs receipts official Anthropic Generates a personal Claude Code activity report from local session transcripts — for justifying spend to a manager or self-review. Claude Code 2,052installs secret-scanning official github This skill guides GitHub secret scanning, push protection, custom patterns, and alert remediation. Use it when a repository needs secret checks before commits or pushes. GitHub Copilot 4,600installs dependabot official github A GitHub Copilot skill that helps write and tune .github/dependabot.yml: grouped updates, monorepo patterns, security updates. GitHub Copilot 4,400installs copilot-spaces official github Pulls Copilot Spaces content into the conversation: team docs, code and instructions. Useful when answers must follow internal standards instead of the model's general knowledge. GitHub Copilot 4,400installs context-driven-development Seth Hobson This skill keeps project context in conductor/, creates and checks its documents, and syncs them as work changes. Use it for setup or codebase onboarding. Claude Code CX Codex Cursor 11,099installs triage Matt Pocock This skill moves issues and external PRs through triage states, verification, and agent briefs. It fits maintainers managing an issue queue. Claude Code 990,453installs code-review Matt Pocock Reviews changes from a chosen reference point against repository standards and the originating spec. Use it for a branch, PR, or work in progress. Claude Code 789,521installs

Questions about cmux-release

How to install cmux-release in Claude Code?

Run npx skills add manaflow-ai/cmux --skill cmux-release -a claude-code in your terminal. You can also place the skill file directly at ~/.claude/skills/cmux-release/SKILL.md.

What does cmux-release do?

It coordinates the version release process for cmux by compiling changelogs from PRs, running version bump scripts, and tagging commits.

What should you do if release-pretag-guard fails?

Run ./scripts/bump-version.sh, commit the incremented build number, and re-run the guard check.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor