warpctrl — скилл для Claude Code: управление окнами Warp
Скилл warpctrl для Claude Code даёт агенту CLI к запущенному приложению Warp: вкладки, панели, буфер ввода, темы и настройки. Запрос про окна самого терминала уходит сюда, а не в правку проекта.
AGPL-3.0 ★ 720 обновлён 2026-11-10
npx skills add dominikmartn/harp --skill warpctrl -a claude-codeЧто делает 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.
Какие задачи решает
- открыть файл в запущенном Warp прямо из агента
- разбить панель и выставить текст в буфер ввода
- переключить тему или открыть нужную страницу настроек
- узнать активные окно, вкладку и сессию до действия
- поставить симлинк
warpctrlв/usr/local/bin
Примеры запросов агенту
- Открой
src/main.rsв новой вкладке Warp. - Раздели текущую панель по вертикали и перейди в неё.
- Покажи активный инстанс Warp и его окно.
Как установить warpctrl
1Через Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill warpctrl -a claude-code2Вручную: положить файлы
~/.claude/skills/warpctrl/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/warpctrl/
1Через Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill warpctrl -a codex2Вручную: положить файлы
.agents/skills/warpctrl/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill warpctrl -a cursor2Вручную: положить файлы
.cursor/skills/warpctrl/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp resources/bundled/skills/warpctrl2Вручную: положить файлы
.github/skills/warpctrl/SKILL.md1Через Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill warpctrl -a gemini-cli2Командой платформы
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/skills/warpctrlВручную: положить файлы
.devin/skills/warpctrl/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о warpctrl
Как установить warpctrl в Claude Code?
Выполнить npx skills add dominikmartn/harp --skill warpctrl -a claude-code. Файл скилла появится по пути ~/.claude/skills/warpctrl/SKILL.md.
Что делает warpctrl?
Управляет уже запущенным приложением Warp через CLI: окна, вкладки, панели, сессии, буфер ввода, темы и настройки. Открывает файлы в Warp и показывает локальное состояние.
Что нужно для работы warpctrl?
Запущенный локальный Warp с обёрткой {{warpctrl_wrapper_path}} в сборке. Если command -v warpctrl ничего не находит, нужен симлинк /usr/local/bin/warpctrl на обёртку.