Cmux Architecture
Reach for this before adding Swift files, refactoring packages, or touching public APIs in the cmux project. It enforces a strict layered DAG architecture (Core, Services, Domain, UI, Executable), dependency inversion through protocol seams, and the Coordinator/Service/Repository pattern. The guidance is opinionated and specific: one major type per file, no dependency cycles, packages own full domains not slices, inject dependencies through constructors not singletons, and use Swift 6 concurrency correctly with actors and MainActor isolation. If you're splitting a god object or wiring a new local package into the Xcode project, this walks you through the mechanical steps and the architectural constraints you must satisfy.
- skills.sh installs
- 5K
- GitHub stars
- 28.7K
- last updated
- Aug 21, 2026
Install
$ npx -y skills add manaflow-ai/cmux --skill cmux-architecture --agent claude-codeInstalls into .claude/skills of the current project.
Files
cmux Architecture
Package architecture
cmux is migrating from a single app target into Swift Packages under Packages/. Every new package must be:
- Ergonomic. Default to internal access;
publiconly what downstream consumers actually use. - Acyclic. Packages form a strict DAG. Share a type by lifting it to a lower package or defining a protocol seam in the consumer. Every new dependency edge requires re-checking that the graph stays acyclic.
- Whole-domain. One package owns a full domain (settings, appearance, workspace, terminal, browser, command palette).
CmuxAppearanceMath+CmuxAppearanceTheme+CmuxAppearanceSettingsis folder structure insideCmuxAppearance, not module structure. A boundary exists because more than one consumer needs the contents, or a build/test seam must exist.
When in doubt, extract leaf-first: the package with no internal dependencies. Existing packages under Packages/ predate this policy; do not use them as design references.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/manaflow-ai/cmux
- Categories
- Documentation, Code Review & Quality, Mobile Development, Design & UI/UX
- First seen
- Jul 14, 2026
More from manaflow-ai/cmux
All 21- Cmux Debugging4.9K
- Cmux Backend4.9K
- Cmux Release4.9K
- Cmux Localization4.9K
- Cmux Socket Policy4.9K
- Cmux Ghostty4.9K
- Cmux Shared Behavior4.8K
- Cmux Debug Windows604
- Release133
- Cmux10.1K
- Cmux Browser9K
- Cmux Markdown7.8K
- Cmux Settings7.6K
- Cmux Workspace7.2K
- Cmux Customization6.9K
- Cmux Diagnostics6.6K
- Cmux Keyboard Shortcuts6.4K
- Cmux Testing5.1K
- Cmux Dev Workflow5K
- Cmux Custom Sidebar5K
Recommended
More Documentation
premium-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
ux-copyanthropics/knowledge-work-pluginsWrite or review UX copy — microcopy, error messages, empty states, CTAs. Trigger with "write copy for", "what should this button say?", "review this error messa5Kskills.sh installs
indexion-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
cmux-localizationmanaflow-ai/cmuxLocalization rules and audit workflow for cmux UI strings, settings rows, menus, shortcuts, schema/config text, docs, command/help text, alerts, tooltips, and w4.9Kskills.sh installs
omnistudio-datapacks-deployforcedotcom/sf-skillsSalesforce Industries DataPack deployment automation using Vlocity Build. TRIGGER when: user deploys or validates OmniStudio/Vlocity DataPacks with vlocity comm4.8Kskills.sh installs
extracttavily-ai/skillsExtract content from specific URLs using Tavily's extraction API. Returns clean markdown/text from web pages. Use when you have specific URLs and need their con4.8Kskills.sh installs