cmux-workspace · manaflow-ai — скилл для Claude Code: работа в текущем воркспейсе
Привязывает действия агента к тому воркспейсу и терминалу cmux, откуда его запустили, чтобы автоматизация не мешала человеку за соседним окном.
npx skills add manaflow-ai/cmux --skill cmux-workspace -a claude-codeЧто делает cmux-workspace
Скилл объясняет агенту иерархию cmux: окно, воркспейс, панель, поверхность. По умолчанию все команды идут в воркспейс вызывающей стороны, а не в тот, что сейчас на экране. Якоря берутся из переменных CMUX_WORKSPACE_ID и CMUX_SURFACE_ID, а если их нет — из cmux identify --json.
Раскладка строится сразу готовыми панелями: cmux new-pane с нужным типом и --command, чтобы первая команда стартовала при создании, а не отдельным send. Переключение фокуса и выбор воркспейса считаются действиями пользователя, поэтому без явной просьбы они не вызываются. Для вспомогательного вывода — превью, логов, разовых оболочек — отводится одна панель справа от терминала вызывающей стороны, и повторные запросы добавляют в неё вкладки, а не новые сплиты.
Есть известная шероховатость: drag-surface-to-split определяет воркспейс через фокус интерфейса, поэтому падает с ERROR: Surface not found, когда активен не тот воркспейс. Обходить это переключением фокуса не стоит — скилл советует сообщить об ошибке и остановиться. Доступ к сокету бывает выключен или ограничен процессами, запущенными из cmux; тогда пригодятся cmux capabilities --json и cmux ping.
Какие задачи решает
- запустить сборку в том воркспейсе, откуда пришёл агент, а не в открытом на экране
- открыть превью приложения в отдельной панели, не сбивая фокус пользователя
- передать сообщение другому агенту, не печатая в его терминал
- вывести статус и прогресс задачи в сайдбар текущего воркспейса
- перенести поверхность в нужную панель без переключения фокуса
Примеры запросов агенту
- Запусти
npm run devв терминале текущего воркспейса cmux - Открой превью на
http://127.0.0.1:8765в панели справа, фокус не трогай - Напиши агенту cmux-remote-status, что фикс уже в main
Как установить cmux-workspace
1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-workspace -a claude-code2Вручную: положить файлы
~/.claude/skills/cmux-workspace/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cmux-workspace/
1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-workspace -a codex2Вручную: положить файлы
.agents/skills/cmux-workspace/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-workspace -a cursor2Вручную: положить файлы
.cursor/skills/cmux-workspace/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install manaflow-ai/cmux cmux-workspace2Вручную: положить файлы
.github/skills/cmux-workspace/SKILL.md1Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-workspace -a gemini-cli2Командой платформы
gemini skills install https://github.com/manaflow-ai/cmux --path skills/cmux-workspaceВручную: положить файлы
.devin/skills/cmux-workspace/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add manaflow-ai/cmux --skill cmux-workspace -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cmux-workspace
Как установить cmux-workspace в Claude Code?
Выполните npx skills add manaflow-ai/cmux --skill cmux-workspace -a claude-code, после чего файл скилла окажется по пути ~/.claude/skills/cmux-workspace/SKILL.md.
Что делает cmux-workspace?
Ограничивает работу агента текущим воркспейсом и терминалом cmux: раскладка собирается аддитивно, фокус и выбор воркспейса без просьбы не меняются.
Почему drag-surface-to-split не находит поверхность?
Команда определяет воркспейс через фокус интерфейса, поэтому при неактивном воркспейсе вызывающей стороны возвращает ERROR: Surface not found. Скилл советует строить раскладку через cmux new-pane, а об ошибке сообщить.
Похожие скиллы
Все скиллы по теме «Настройка агента: память, контекст, субагенты» →Сначала — cmux-workspace от других авторов.
