# warpctrl

Скилл warpctrl для Claude Code даёт агенту CLI к запущенному приложению Warp: вкладки, панели, буфер ввода, темы и настройки. Запрос про окна самого терминала уходит сюда, а не в правку проекта.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 720 у репозитория
- Автор: dominikmartn
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/dominikmartn/harp/tree/HEAD/resources/bundled/skills/warpctrl/SKILL.md
- Обновлён: 2026-11-10
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/warpctrl

## Что делает

Внутри скилла лежит вызов `warpctrl` — скрытого режима управления, который отдаёт сам запущенный процесс Warp. Отдельного бинарника нет. Имя команды и путь обёртки подставляются под текущий канал Warp, поэтому искать процессы руками и угадывать канал незачем. Запрос маршрутизируется в самую узкую группу: `surface` для панелей, пикеров и страниц настроек, `window`, `tab`, `pane`, `session` для раскладки, `input` для текста в редакторе, `file` для открытия пути, `theme`, `appearance`, `setting`, `keybinding` для конфигурации, а общий каталог `action` берут, когда своей группы нет.

Сначала `warpctrl instance list`. Точные параметры читаются из `warpctrl help`, `warpctrl <group> help` и `warpctrl <group> <command> --help`. Если инстансов одного канала несколько, нужен `--instance <instance_id>` или `--pid <pid>`. Команды идут строго по одной: параллельные вызовы делят одну активную цель, и следующая команда может уйти в чужую панель. После создания, фокуса или перехода цель перечитывают через `warpctrl app active`, а результат сверяют командой `list`, `inspect` или `get`.

Нужен запущенный локально Warp: обёртка `{{warpctrl_wrapper_path}}` должна быть в сборке. Когда `command -v warpctrl` молчит, ставится симлинк `/usr/local/bin/warpctrl` на эту обёртку командой `ln -sf`, и только после согласия пользователя. На macOS при нехватке прав та же команда идёт через `osascript` с правами администратора. Пункты установки и удаления CLI есть в Command Palette и в Settings > Scripting.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill warpctrl -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill warpctrl -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill warpctrl -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dominikmartn/harp resources/bundled/skills/warpctrl
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dominikmartn/harp --skill warpctrl -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/skills/warpctrl
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dominikmartn/harp/tree/HEAD/resources/bundled/skills/warpctrl/SKILL.md

## Когда брать
- открыть файл в запущенном Warp прямо из агента
- разбить панель и выставить текст в буфер ввода
- переключить тему или открыть нужную страницу настроек
- узнать активные окно, вкладку и сессию до действия
- поставить симлинк `warpctrl` в `/usr/local/bin`

## Примеры запросов агенту
- Открой `src/main.rs` в новой вкладке Warp.
- Раздели текущую панель по вертикали и перейди в неё.
- Покажи активный инстанс Warp и его окно.

## Похожие
- [cli-for-agents](https://affpapa.org/nevibecode/skills/cli-for-agents.md) — скилл · 1400 установок
- [cmux-cli](https://affpapa.org/nevibecode/skills/cmux-cli.md) — скилл · 908 установок
- [tmux](https://affpapa.org/nevibecode/skills/tmux.md) — скилл · 8500 установок
- [cate-cli](https://affpapa.org/nevibecode/skills/cate-cli.md) — скилл · ★ 2248 у репозитория
- [warp-delegate](https://affpapa.org/nevibecode/skills/warp-delegate.md) — скилл · 3100 установок
- [cmux](https://affpapa.org/nevibecode/skills/cmux.md) — скилл · 10200 установок

Из того же набора: [dominikmartn/harp](https://affpapa.org/nevibecode/by/dominikmartn/harp.md) — 62 карточки

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