Skip to content
Development
Command

/cleanup-builds

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

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

Command definition

cleanup-builds.md

Cleanup Dev Builds

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

Steps

1. **Preview.** `./scripts/cleanup-dev-builds.sh` is dry-run by default and prints what would be deleted, what is skipped, and total reclaimable bytes.

2. **Read the preview to the user.** Confirm the active tag and any tag they care about appears under `skipping:`.

3. **Ask before deleting.** Never run `--apply` without explicit confirmation. Surface tags they may want to protect with `--keep <tag>`.

4. **Apply.** `./scripts/cleanup-dev-builds.sh --apply`. Optional: `--keep <tag>` (repeatable) to protect specific tags, `--older-than <DAYS>` to skip recently touched artifacts.

5. **Report** the freed-bytes total from the script's final line.

Notes

Always-on safety rules: skip running `cmux DEV <tag>` apps, and skip the tag in `/tmp/cmux-last-cli-path` (the most recent reload). An existing HQ worktree is not protection; use `--keep`. The script never touches `GhosttyKit.xcframework` symlinks, the GhosttyKit cache, or anything outside per-tag artifacts.

@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.8k
Star history of manaflow-ai/cmux on GitHub, a chart by star-history.com

Other commands on cmux.

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