Skip to content
Development
Command

/release-local

Release straight from `main` with no PR, built and published locally.

From plugin
cmux
29k7 skills7 commands
$ npx -y skills add manaflow-ai/cmux --agent claude-code

Command definition

release-local.md

Release Local

Release straight from `main` with no PR, built and published locally.

Follow [release.md](release.md) "Shared prep" (version, changelog, contributors, `./scripts/bump-version.sh`) and its changelog and contributor-credit rules. `skills/cmux-release/SKILL.md` covers the bump and tag mechanics.

Delta: no PR, tag on main, local build

1. **Commit on main.** Stage `CHANGELOG.md` and `cmux.xcodeproj/project.pbxproj`, commit `Bump version to X.Y.Z`.

2. **Guard, tag, push.**

   ./scripts/release-pretag-guard.sh
   git tag vX.Y.Z
   git push origin main && git push origin vX.Y.Z

If the guard fails, run `./scripts/bump-version.sh`, commit the build-number bump, and rerun the guard.

3. **Build, sign, notarize, upload.**

   ./scripts/build-sign-upload.sh vX.Y.Z

The script does GhosttyKit build, xcodebuild, Sparkle key injection, codesigning, notarization of app and DMG, appcast generation, GitHub release upload of `cmux-macos.dmg` and `appcast.xml`, homebrew cask update, cleanup, and `say "cmux release complete"` on success. Pass `--allow-overwrite` only to replace existing assets on the same tag during an emergency reroll. If it fails, run `say "cmux release failed"`.

4. **Verify and land the homebrew cask.**

   bash tests/test_homebrew_sha.sh
   git add homebrew-cmux && git commit -m "Update homebrew-cmux submodule to latest" && git push origin main
Read more
@manaflow-ai
Ships withcmux

Open source Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents. Built for multitasking, organization, and programmability.

Stars on GitHub

Momentum

stars in total
28.6k
Star history of manaflow-ai/cmux on GitHub, a chart by star-history.com

Other commands on cmux.

cleanup-builds

cleanup-builds

Command

Reclaim disk taken by tagged dev artifacts from `./scripts/reload.sh --tag <tag>`. Each tagged build is multi-GB of DerivedData…

@manaflow-ai@manaflow-aiInstall Command
pull

pull

Command

Pull latest main and update all submodules to their latest remote main. No commits, no pushes.

@manaflow-ai@manaflow-aiInstall Command
release-nightly

release-nightly

Command

Release through the PR flow, then build and publish locally instead of waiting on the CI release workflow.

@manaflow-ai@manaflow-aiInstall Command
release

release

Command

Ship a stable cmux release built by CI: bump version, update changelog, open a PR, merge, tag, then GitHub Actions builds, signs,…

@manaflow-ai@manaflow-aiInstall Command
review

review

Command

Run an adversarial review of the current change using the repository's cmux review skill.

@manaflow-ai@manaflow-aiInstall Command
sync-branch

sync-branch

Command

Get the current branch ready: update all submodules to their latest remote main, merge from main, and rebase.

@manaflow-ai@manaflow-aiInstall Command

More commands from other plugins.

build
Auto-invoked

build

Command

Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.

@addyosmani@addyosmaniInstall Command