# cmux-workspace

Привязывает действия агента к тому воркспейсу и терминалу cmux, откуда его запустили, чтобы автоматизация не мешала человеку за соседним окном.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 6900 установок · ★ 28491
- Автор: manaflow-ai
- Лицензия: GPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/manaflow-ai/cmux/tree/HEAD/skills/cmux-workspace/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/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`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manaflow-ai/cmux --skill cmux-workspace -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/cmux-workspace/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/cmux-workspace/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manaflow-ai/cmux --skill cmux-workspace -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/cmux-workspace/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manaflow-ai/cmux --skill cmux-workspace -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/cmux-workspace/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install manaflow-ai/cmux cmux-workspace
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/cmux-workspace/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add manaflow-ai/cmux --skill cmux-workspace -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/manaflow-ai/cmux --path skills/cmux-workspace
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/cmux-workspace/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add manaflow-ai/cmux --skill cmux-workspace -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/manaflow-ai/cmux/tree/HEAD/skills/cmux-workspace/SKILL.md

## Когда брать
- запустить сборку в том воркспейсе, откуда пришёл агент, а не в открытом на экране
- открыть превью приложения в отдельной панели, не сбивая фокус пользователя
- передать сообщение другому агенту, не печатая в его терминал
- вывести статус и прогресс задачи в сайдбар текущего воркспейса
- перенести поверхность в нужную панель без переключения фокуса

## Примеры запросов агенту
- Запусти `npm run dev` в терминале текущего воркспейса cmux
- Открой превью на `http://127.0.0.1:8765` в панели справа, фокус не трогай
- Напиши агенту cmux-remote-status, что фикс уже в main

## Похожие
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [ask-matt](https://affpapa.org/nevibecode/skills/ask-matt.md) — скилл · 766587 установок
- [to-tickets](https://affpapa.org/nevibecode/skills/to-tickets.md) — скилл · 711230 установок
- [writing-plans](https://affpapa.org/nevibecode/skills/writing-plans.md) — скилл · 282859 установок
- [caveman-review](https://affpapa.org/nevibecode/skills/caveman-review.md) — скилл · 411800 установок
- [caveman-compress](https://affpapa.org/nevibecode/skills/caveman-compress.md) — скилл · 411500 установок

## Другие версии с тем же именем
- [cmux-workspace · manaflow-ai](https://affpapa.org/nevibecode/skills/manaflow-ai-cmux-workspace.md) — 755 установок

Из того же набора: [manaflow-ai/cmux](https://affpapa.org/nevibecode/by/manaflow-ai/cmux.md) — 24 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md