Skip to content
LiveNew tools this week
Submit
AIMarketly
cmux-release logo

cmux Release

cmux-release

cmux release workflow, version bumping, changelog updates, pretag guard, release tags, and release asset expectations. Use when preparing or troubleshooting a cmux release.

manaflow-ai/cmux4.5Kinstalls27.6Kstars

SKILL.md

Full skill instructions

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;
  • none is 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/Removed prefix, 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

This 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.

Tagging

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

If the pretag guard fails, run ./​scripts/​bump-version.sh, commit the build-number bump, then retry.

Release artifacts and secrets

  • The release asset is cmux-macos.dmg, attached to the tag. The README download button points to releases/​latest/​download/​cmux-macos.dmg.
  • Signing requires the GitHub secrets APPLE_CERTIFICATE_BASE64, APPLE_CERTIFICATE_PASSWORD and APPLE_SIGNING_IDENTITY. CI notarization authenticates with the team App Store Connect API key (ASC_API_KEY_ID, ASC_API_ISSUER_ID, ASC_API_KEY_P8_BASE64) through scripts/​ci/​lib/​notary-auth.sh, which decodes the key to a mode-600 temp file that the caller deletes. The local scripts/​build-sign-upload.sh still uses an Apple ID and app-specific password.

Detailed reference

More skills from manaflow-ai

cmux-keyboard-shortcuts logo
manaflow-ai/cmux

cmux-keyboard-shortcuts

Guide and apply cmux keyboard shortcut customization. Use when the user asks to customize, rebind, unbind, reset, audit, or create shortcut templates for cmux, including tmux-style, Vim-style, terminal-first, browser-heavy, iTerm/Terminal-like, or agent-triage layouts.

27.6K 5.9K
View
cmux-testing logo
manaflow-ai/cmux

cmux-testing

cmux testing rules for Swift Testing, test target compilation, test wiring, and package/refactor validation. Use when adding or changing tests, touching package/refactor code, or deciding whether reload.sh is enough validation.

27.6K 4.7K
View
cmux-dev-workflow logo
manaflow-ai/cmux

cmux-dev-workflow

Contributor workflow rules for cmux setup, Xcode project normalization, tagged sidebar ExtensionKit development, and dev builds. Use when setting up the cmux repo, changing Xcode project files, adding sidebar extensions, or working with tagged debug builds.

27.6K 4.7K
View
cmux-architecture logo
manaflow-ai/cmux

cmux-architecture

cmux package architecture, refactor layering, dependency inversion, file organization, DocC documentation, package design discipline, testability, and Swift 6 concurrency rules. Use before adding or meaningfully rewriting Swift files, Swift packages, coordinators, services, repositories, or public package APIs.

27.6K 4.6K
View
cmux-debugging logo
manaflow-ai/cmux

cmux-debugging

Debug logging, Debug menu, runtime pitfalls, typing-latency-sensitive paths, SwiftUI list snapshot boundaries, OS-version repros, and local visual iteration for cmux. Use when adding debug probes, diagnosing UI/runtime issues, touching terminal rendering, tab/sidebar list views, drag/drop UTTypes, or using the Debug menu.

27.6K 4.5K
View
cmux-custom-sidebar logo
manaflow-ai/cmux

cmux-custom-sidebar

Build a custom cmux sidebar from a plain-language request. Use when the user asks for a custom sidebar, a sidebar that shows their workspaces/tabs/PRs/clock, a vibe-coded sidebar, or anything involving files in ~/.config/cmux/sidebars/. Covers authoring the interpreted SwiftUI-style file, enabling the beta flag, selecting it, and iterating with hot reload.

27.6K 4.5K
View
cmux-backend logo
manaflow-ai/cmux

cmux-backend

Backend TypeScript and Cloud VM development rules for cmux. Use when editing web/app/api, web/services, backend scripts, Cloud VM lifecycle, provider integrations, Postgres, Stack Auth pricing gates, migrations, or provider image build scripts.

27.6K 4.5K
View
cmux-localization logo
manaflow-ai/cmux

cmux-localization

Localization rules and audit workflow for cmux UI strings, settings rows, menus, shortcuts, schema/config text, docs, command/help text, alerts, tooltips, and web messages. Use whenever changing user-facing text.

27.6K 4.5K
View
cmux-socket-policy logo
manaflow-ai/cmux

cmux-socket-policy

Socket command threading and focus policy for cmux CLI/socket work. Use when adding or changing socket commands, CLI commands, telemetry commands, focus/select/open/close/send-key behavior, or automation that could steal app focus.

27.6K 4.5K
View

Popular AI tools

View all
Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View
IMGCreator.ai logo
Images

IMGCreator.ai

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View
Clipdrop Uncrop logo
Images

Clipdrop Uncrop

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C
Finance

ChainClarity

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View