cmux-socket-policy

What problem does it solve?

Socket command handling in cmux can inadvertently steal focus or block UI updates on the main thread, leading to disruptive user experiences. This Skill defines threading and focus policies to ensure safe, focus-preserving command execution for socket/CLI/telemetry commands, with clear guidelines for main-thread usage and explicit focus intent.

Core Features & Use Cases

• Off-main processing for high-frequency telemetry commands to avoid UI stutter.
• Main-actor guidance for commands that manipulate UI state, including when to require explicit focus intent.
• Clear documentation and references to enforce consistency across new socket/CLI commands.
• Use Case: When adding a new socket command, telemetry handler, or automation that could grab focus, apply the policy.

Quick Start

Configure a new cmux socket or CLI command with off-main handling, document focus behavior, and reference the threading-and-focus.md guidance.