Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dominikmartn/harp --skill warpctrl -a claude-code
Open on GitHub

What 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 warpctrl into /usr/local/bin

Example prompts for the agent

  • Open src/main.rs in 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-code

2Manually: put the files in place

~/.claude/skills/warpctrl/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/warpctrl/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set62

The whole set →
factory-files factory-files is a Claude Code skill that authors Warp software factory files in a repo tree rooted at factory.yaml and validates them on the server before a pull request. CX Codex +1 ★ 720repo stars gui-integration-test-video gui-integration-test-video is a Claude Code skill for recording video and screenshots from Warp GUI integration tests. It applies when creating a test capture or checking its output. CX Codex +1 ★ 720repo stars cross-platform-cloud-verification The cross-platform-cloud-verification skill for Claude Code manages cost-effective cloud testing across multiple operating systems and architectures. It runs for changes with cross-platform impacts. CX Codex +1 ★ 720repo stars review-pr-local review-pr-local is a Claude Code skill that applies Warp repository rules to pull request reviews. It extends the core review-pr skill. CX Codex +1 ★ 720repo stars gui-create-launch-modal gui-create-launch-modal is a Claude Code skill for building a one-time launch modal in Warp’s GUI. A feature flag controls the startup display for each user. CX Codex +1 ★ 720repo stars changelog-draft changelog-draft is a Claude Code skill that turns pull requests merged between two release tags into a changelog draft, keeping explicit CHANGELOG markers and sorting the rest into categories. CX Codex +1 ★ 720repo stars oz-platform oz-platform is a Claude Code skill for running and inspecting Oz cloud agents through Warp's REST API and CLI. It also handles schedules and agent environments. CX Codex +1 ★ 720repo stars rust-unit-tests rust-unit-tests is a Claude Code skill that writes and improves Rust unit tests within the codebase. It assists when handling data transformations or fixing reproducible bugs. CX Codex +1 ★ 720repo stars

Project sponsors

Companies that keep this analytics open