manaflow-ai avatar

Cmux Dev Workflow

Opinionated workflow automation for the cmux terminal project: tagged debug builds that don't steal focus from each other, Xcode project file normalization via pre-commit hooks, and ExtensionKit sidebar extension tagging so multiple dev builds can coexist without colliding in pkd. The reload script enforces tagged builds by default, the setup script installs git hooks that sort pbxproj sections before commit, and the extension tooling manages the triple of bundle ID, display name, and extension point ID so the OS treats concurrent builds as distinct. You'll want this if you're contributing to cmux or building something similar where untagged debug apps sharing a socket is a daily annoyance.

skills.sh installs
5K
GitHub stars
28.7K
last updated
Aug 21, 2026

Install

$ npx -y skills add manaflow-ai/cmux --skill cmux-dev-workflow --agent claude-code

Installs into .claude/skills of the current project.

Files

cmux Dev Workflow

Scope and routing

Run repository commands only from a trusted checkout; even verify-local.py --help and --list load repository code.

Choose verification for the change before preparing a native build. Fast feedback starts with python3 scripts/verify-local.py; portable-tooling and documentation changes use their scoped checks without an unrelated app build.

For native app or build-input changes, build with a tag as below. Setup (./scripts/setup.sh) initializes submodules, builds GhosttyKit and installs the project-normalization hook; it is not a prerequisite for portable static checks.

Tagged local development

When local native execution is authorized:

./scripts/reload.sh --tag <short-tag>
CMUX_TAG=<short-tag> scripts/cmux-debug-cli.sh list-workspaces

Sponsors

Details

Repository
github.com/manaflow-ai/cmux
Categories
Debugging, Automation & Workflows, Mobile Development
First seen
Jul 14, 2026

More from manaflow-ai/cmux

All 21

Recommended

More Debugging
1github avatarpremium-frontend-uigithub/awesome-copilotA comprehensive guide for GitHub Copilot to craft immersive, high-performance web experiences with advanced motion, typography, and architectural craftsmanship.5Kskills.sh installs
2grafana avatarmimirgrafana/skillsStand up Grafana Mimir for horizontally scalable, multi-tenant, long-term Prometheus + OTLP metrics storage. Covers monolithic / read-write / microservices depl5Kskills.sh installs
3trkbt10 avatarindexion-refactortrkbt10/indexion-skillsAfter writing code, detect and clean up duplication at three levels — copy-paste blocks, cross-package shared code, unnecessary wrappers, and concept-level SoT 5Kskills.sh installs
4affaan-m avatarkubernetes-patternsaffaan-m/eccKubernetes workload patterns, resource management, RBAC, probes, autoscaling, ConfigMap/Secret handling, and kubectl debugging for production-grade deployments.4.9Kskills.sh installs
5manaflow-ai avatarcmux-releasemanaflow-ai/cmuxcmux release workflow, version bumping, changelog updates, pretag guard, release tags, and release asset expectations. Use when preparing or troubleshooting a c4.9Kskills.sh installs
6giuseppe-trisciuoglio avatarreact-patternsgiuseppe-trisciuoglio/developer-kitProvides comprehensive React 19 patterns for Server Components, Server Actions, useOptimistic, useActionState, useTransition, concurrent features, Suspense boun4.9Kskills.sh installs