cmux-socket-policy — скилл Claude Code: установка
Скилл задаёт правила потоков, фокуса и удалённой ретрансляции для socket- и CLI-команд cmux. Нужен при добавлении или изменении таких команд.
npx skills add manaflow-ai/cmux --skill cmux-socket-policy -a claude-codeЧто делает cmux-socket-policy
Скилл помогает проверять новые socket- и CLI-команды cmux. Для частой телеметрии он требует разбирать и проверять аргументы вне главного потока, там же объединять повторяющиеся обновления, а изменения интерфейса передавать в DispatchQueue.main.async только при необходимости. Команды, которые меняют состояние AppKit или Ghostty, могут работать в главном акторе. Новая socket-команда по умолчанию должна обрабатываться вне главного потока; исключение нужно объяснить комментарием в коде.
Отдельные правила сохраняют текущий фокус macOS-приложения: обычные команды не должны активировать приложение или поднимать окна. Команды открытия фокусируют окно только при интерактивном запуске; агент или скрипт оставляет их в фоне, а параметры --focus и --no-focus меняют это поведение. Скилл также напоминает, что каждый метод v2 может попасть в ретрансляцию cmux ssh: RemoteRelayCommandPolicy запрещает такие методы по умолчанию, а разрешение требует анализа безопасности и тестов политики.
Какие задачи решает
- проверить поток выполнения новой socket-команды
- вынести телеметрию из главного потока
- сохранить текущий фокус приложения при автоматизации
- разрешить метод v2 для ретрансляции через
cmux ssh - разобрать поведение фокуса у команд открытия
Примеры запросов агенту
- Проверь новую socket-команду: аргументы и дедупликация должны обрабатываться вне главного потока.
- Разбери, должен ли
surface openменять фокус при запуске агентом, и проверь варианты--focusи--no-focus. - Проведи проверку метода v2 перед разрешением ретрансляции через
cmux sshи опиши нужные тесты политики.
Как установить cmux-socket-policy
1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-socket-policy -a claude-code2Вручную: положить файлы
~/.claude/skills/cmux-socket-policy/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cmux-socket-policy/
1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-socket-policy -a codex2Вручную: положить файлы
.agents/skills/cmux-socket-policy/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-socket-policy -a cursor2Вручную: положить файлы
.cursor/skills/cmux-socket-policy/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install manaflow-ai/cmux cmux-socket-policy2Вручную: положить файлы
.github/skills/cmux-socket-policy/SKILL.md1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-socket-policy -a gemini-cli2Командой платформы
gemini skills install https://github.com/manaflow-ai/cmux --path skills/cmux-socket-policyВручную: положить файлы
.devin/skills/cmux-socket-policy/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-socket-policy -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cmux-socket-policy
Как установить cmux-socket-policy в Claude Code?
Выполните npx skills add manaflow-ai/cmux --skill cmux-socket-policy -a claude-code, затем проверьте файл ~/.claude/skills/cmux-socket-policy/SKILL.md.
Что делает cmux-socket-policy?
Скилл задаёт правила обработки socket- и CLI-команд cmux: телеметрия уходит из главного потока, обычные команды сохраняют фокус, а методы v2 проходят проверку ретрансляции.
Когда команда открытия cmux получает фокус?
При интерактивном запуске команды открытия могут фокусировать окно. Запуск агентом или скриптом оставляет его в фоне; --focus включает фокус, а --no-focus отключает его.