Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

cmux-architecture — Claude Code skill: what it does, how to install

Guides modular Swift package architecture, strict 5-layer dependency inversion, and Swift 6 concurrency rules in the cmux codebase.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add manaflow-ai/cmux --skill cmux-architecture -a claude-code
Open on GitHub

What cmux-architecture does

The skill directs the migration of cmux from a monolithic app target into modular Swift packages under Packages/. It enforces a strict downward five-layer hierarchy: pure Sendable primitives in CmuxCore, infrastructure actors, @Observable domain state, SwiftUI packages, and a thin executable root. Singletons and global containers are banned in favor of initializer-based dependency injection.

Project integrity relies on local Python verification scripts. Moving or adding packages requires running python3 scripts/check-workspace-package-groups.py, while CI checks Package.resolved files using python3 scripts/check-package-resolved-policy.py. Existing modules in the repository must not serve as reference designs, because they predate this strict architecture standard. Every new file must hold only one primary type.

What it helps with

  • split the cmux monolith into isolated Swift packages
  • refactor legacy shared singletons into initializer dependency injection
  • migrate UI state models from ObservableObject to Observable
  • isolate process and PTY operations into dedicated background actors

Example prompts for the agent

  • Extract CmuxAppearance into an isolated Swift package using cmux-architecture rules
  • Refactor this settings manager into an actor service and an observable coordinator
  • Check this package structure to verify the dependency graph remains acyclic

How to install cmux-architecture

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-architecture -a claude-code

2Manually: put the files in place

~/.claude/skills/cmux-architecture/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cmux-architecture/

From the same set12

The whole set →
cmux manaflow-ai Skill for navigating multi-pane cmux layouts: create windows, workspaces, splits, focus surfaces, and move terminals and browser panels without breaking automation. Use it when an agent needs deterministic placement and routing. Claude Code CX Codex Cursor +1 9,600installs cmux-browser manaflow-ai Automates browser surfaces via the cmux CLI without stealing user focus. Useful for background page inspections, waiting on selectors, and form fills. Claude Code CX Codex Cursor +1 8,800installs cmux-customization manaflow-ai Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty. Claude Code CX Codex Cursor +1 6,600installs cmux-diagnostics manaflow-ai Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report. Claude Code CX Codex Cursor +1 6,400installs cmux-keyboard-shortcuts manaflow-ai Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. Claude Code CX Codex Cursor +1 6,200installs cmux-testing manaflow-ai Skill for choosing verification scopes, adding tests, and validating Swift test targets in the cmux project. Decides what local and CI evidence a change needs. Claude Code CX Codex Cursor +1 4,900installs cmux-custom-sidebar manaflow-ai Skill for writing a custom cmux sidebar in a SwiftUI-like language. The sidebar binds to workspaces, tabs, PRs, and clock; hot-reloads on save; runs cmux commands on tap. Claude Code CX Codex Cursor +1 4,800installs cmux-ghostty manaflow-ai Enforces workflow guidelines for the Ghostty submodule and GhosttyKit compilation in cmux. Useful when syncing the fork or committing submodule pointers. Claude Code CX Codex Cursor +1 4,700installs

Similar

react-modernization Seth Hobson This skill upgrades React codebases, moves class components to hooks, and guides React 18 adoption. Use it when a legacy React app needs a structured migration. Claude Code CX Codex Cursor 12,625installs clojure-review metabase Reviews Clojure and ClojureScript code against Metabase engineering guidelines and flags styling mistakes in diffs. Claude Code CX Codex Cursor +1 2,000installs design-review nexu-io Audits UI visually, fixes flaws with atomic commits, and captures before/after screenshots. Useful for tightening shipped interface code right before launch. Claude Code CX Codex Cursor +1 3,100installs typescript-pro https://github.com/Jeffallan Implements advanced TypeScript type systems, branded types, and tRPC configurations. Use it when building type-first APIs or complex discriminated unions. Claude Code CX Codex Cursor +1 14,200installs memory-safety-patterns Seth Hobson This skill applies ownership, RAII, smart pointers, and resource management to Rust, C++, and C. Use it for systems code or memory-bug debugging. Claude Code CX Codex Cursor 11,746installs improve-codebase-architecture Matt Pocock This skill scans a codebase for architectural friction, then builds a visual HTML report with refactoring candidates. Use it before a deeper architecture review. Claude Code 1,163,035installs tdd Matt Pocock Guides the red-green TDD loop: ensures tests are written first, keep them at public interfaces, and avoid coupling to implementation details. Claude Code 1,141,062installs triage Matt Pocock This skill moves issues and external PRs through triage states, verification, and agent briefs. It fits maintainers managing an issue queue. Claude Code 990,453installs

Questions about cmux-architecture

How do I install cmux-architecture in Claude Code?

Run npx skills add manaflow-ai/cmux --skill cmux-architecture -a claude-code in your terminal.

What does cmux-architecture do?

It provides architecture constraints for cmux, enforcing a five-layer hierarchy, protocol-based dependency inversion, actor-isolated services, and SwiftUI @Observable state.

How does cmux-architecture handle feature flags?

It requires runtime flags to use PostHog via CmuxFeatureFlags with explicit fallback values, unless a local setting or build flag is requested directly.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor