warpctrl — Claude Code skill: drive Warp windows and panes
warpctrl is a Claude Code skill that hands the agent a CLI into the Warp app already open on the machine: tabs, panes, the input buffer, themes, settings. Requests about Warp's own windows land here instead of the project tree.
AGPL-3.0 ★ 720 updated 2026-11-10
npx skills add dominikmartn/harp --skill warpctrl -a claude-codeWhat warpctrl does
The skill calls warpctrl, a hidden control mode that the running Warp process serves; there is no standalone binary. Command name and wrapper path are injected for the active Warp channel, so scanning processes or guessing a channel gets nothing. Routing picks the narrowest group: surface covers panels, pickers and settings pages, window, tab, pane and session cover layout, input stages editor text, file opens a path, theme, appearance, setting and keybinding handle configuration. The generic action catalog is the fallback.
Start with warpctrl instance list, then read warpctrl help and warpctrl <group> help for real parameters rather than inventing flags. Two or more instances on the same channel need --instance <instance_id> or --pid <pid>. Run calls one after another — parallel shell calls share one active target, so a later command can hit the wrong pane. Anything that creates, focuses or navigates gets re-read with warpctrl app active, and a list, inspect or get result confirms the end state.
The runtime is a local Warp that is already up, with the wrapper {{warpctrl_wrapper_path}} present in the build. If command -v warpctrl finds nothing, the expected symlink at /usr/local/bin/warpctrl pointing at that wrapper is created with ln -sf, and only once the user says yes. On macOS a permission error sends the same command through osascript with admin rights.
What it helps with
- open a file in the running Warp from the agent
- split a pane and stage text in the input buffer
- switch theme or jump to a settings page
- read the active window, tab and session first
- link
warpctrlinto/usr/local/bin
Example prompts for the agent
- Open
src/main.rsin a new Warp tab. - Split the current pane vertically and focus it.
- Which Warp instance is active, and which window is in front?
How to install warpctrl
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill warpctrl -a claude-code2Manually: put the files in place
~/.claude/skills/warpctrl/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/warpctrl/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill warpctrl -a codex2Manually: put the files in place
.agents/skills/warpctrl/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill warpctrl -a cursor2Manually: put the files in place
.cursor/skills/warpctrl/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp resources/bundled/skills/warpctrl2Manually: put the files in place
.github/skills/warpctrl/SKILL.md1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill warpctrl -a gemini-cli2Platform CLI
gemini skills install https://github.com/dominikmartn/harp --path resources/bundled/skills/warpctrlManually: put the files in place
.devin/skills/warpctrl/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about warpctrl
How do I install warpctrl in Claude Code?
Run npx skills add dominikmartn/harp --skill warpctrl -a claude-code. The skill file ends up at ~/.claude/skills/warpctrl/SKILL.md.
What does warpctrl do?
It drives the Warp app that is already running: windows, tabs, panes, sessions, staged input, themes and settings. It also opens files in Warp and reports local Warp state.
What does warpctrl need in order to work?
A local Warp session that is up, plus the {{warpctrl_wrapper_path}} wrapper inside that build. When command -v warpctrl returns nothing, a symlink at /usr/local/bin/warpctrl points to the wrapper.