Agent Skills › manaflow-ai/cmux › cmux-socket-policy

cmux-socket-policy

GitHub

定义 cmux CLI/socket 命令的线程调度与焦点保持策略，指导新增或修改 socket、CLI 及遥测命令时的主/非主线程执行规范及焦点行为约束。

skills/cmux-socket-policy/SKILL.md manaflow-ai/cmux

Trigger Scenarios

添加新的 socket 命令修改 CLI 命令执行逻辑涉及应用焦点或选择状态变更的自动化操作

Install

npx skills add manaflow-ai/cmux --skill cmux-socket-policy -g -y

More Options

Use without installing

npx skills use manaflow-ai/cmux@cmux-socket-policy

指定 Agent (Claude Code)

npx skills add manaflow-ai/cmux --skill cmux-socket-policy -a claude-code -g -y

安装 repo 全部 skill

npx skills add manaflow-ai/cmux --all -g -y

预览 repo 内 skill

npx skills add manaflow-ai/cmux --list

SKILL.md

Frontmatter

{
    "name": "cmux-socket-policy",
    "description": "Socket command threading and focus policy for cmux CLI\/socket work. Use when adding or changing socket commands, CLI commands, telemetry commands, focus\/select\/open\/close\/send-key behavior, or automation that could steal app focus."
}

cmux Socket Policy

Threading policy

Do not use DispatchQueue.main.sync for high-frequency socket telemetry commands such as report_*, ports_kick, status/progress updates, or log metadata updates.
For telemetry hot paths, parse and validate arguments off-main.
Dedupe and coalesce off-main first.
Schedule minimal UI/model mutation with DispatchQueue.main.async only when needed.
Commands that directly manipulate AppKit/Ghostty UI state are allowed to run on the main actor.
If adding a new socket command, default to off-main handling and require an explicit reason in code comments when main-thread execution is necessary.

Focus policy

Socket/CLI commands must not steal macOS app focus.
Do not activate the app or raise windows unless the command has explicit focus intent.
Only explicit focus-intent commands may mutate in-app focus/selection.
Explicit focus-intent commands include window.focus, workspace.select/next/previous/last, surface.focus, pane.focus/last, browser focus commands, and v1 focus equivalents.
All non-focus commands should preserve the current user focus context while still applying data/model changes.