Cmux Shared Behavior

Prevents the classic bug where you fix something in the UI but forget the keyboard shortcut still runs the old broken code. This enforces a single mutation path when behavior surfaces through multiple entrypoints like command palette, context menus, CLI commands, settings, and debug tools. Also covers the optimistic update pattern: one mutation path, track pending state with request IDs, reconcile against the authoritative result, and roll back explicitly on failure. The missed-bug coverage rule is smart: if tests didn't catch something, you add behavior-level tests around the exact repro before calling it done. Basically architectural discipline for cmux to avoid duplicated logic across surfaces.

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

View on GitHub

Install

$ npx -y skills add manaflow-ai/cmux --skill cmux-shared-behavior --agent claude-code

Installs into .claude/skills of the current project.

Files

cmux Shared Behavior

Shared entrypoints

When a behavior is exposed through multiple surfaces (keyboard shortcut, command palette, context menu, CLI/socket command, settings UI, debug menu), implement one shared action/model path and verify every entrypoint that should invoke it. Do not patch one surface and leave the others with duplicated logic.

Optimistic updates

Keep one mutation path. Record pending state with a request id or a previous snapshot, reconcile from the authoritative result, and handle failure with an explicit rollback or error state. Never let each entrypoint maintain its own optimistic copy.