How do I install the Cursor Plugin Warp skill?

Run npx skillmds@latest add kunanonj/cursor-plugin-warp in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cursor Plugin Warp safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cursor Plugin Warp?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cursor Plugin Warp free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cursor Plugin Warp?

KunanonJ (@kunanonj) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cursor Plugin Warp by kunanonj — Agent Skill

Name: Cursor Plugin Warp
Author: KunanonJ

Cursor Plugin Warp

Warp terminal integration for Claude Code — native notifications via OSC 777 escape sequences. Hooks into SessionStart, Stop, Notification, PermissionRequest, UserPromptSubmit, and PostToolUse lifecycle events. Sends structured JSON payloads to Warp for session status, idle prompts, permission requests, and task completion.

KunanonJ 9a3006b 11 files · 15.2 KB Updated Sep 17, 2026

File contents

Warp Terminal Integration

Native Warp terminal notifications for Claude Code sessions. Uses OSC 777 escape sequences to send structured JSON payloads to Warp's cli-agent notification system.

Hooks

Hook	Trigger	Purpose
SessionStart	startup, resume	Emit plugin version, detect Warp
Stop	session end	Notify task completion with last query/response
Notification	idle_prompt	Alert when Claude is idle and waiting for input
PermissionRequest	tool approval	Notify when Claude needs permission to run a tool
UserPromptSubmit	prompt sent	Transition session status back to running
PostToolUse	tool complete	Transition session from blocked back to running

Protocol

Payloads follow the cli-agent notification schema with version negotiation:

{
  "v": 1,
  "agent": "claude",
  "event": "stop|session_start|idle_prompt|permission_request|prompt_submit|tool_complete",
  "session_id": "...",
  "cwd": "...",
  "project": "..."
}

The should-use-structured.sh guard checks WARP_CLI_AGENT_PROTOCOL_VERSION and WARP_CLIENT_VERSION to avoid sending structured notifications to Warp builds that advertise protocol support but cannot render them.

Scripts

build-payload.sh — Shared payload builder with protocol version negotiation
should-use-structured.sh — Feature detection for structured notification support
warp-notify.sh — OSC 777 escape sequence emitter to /dev/tty
on-session-start.sh — SessionStart hook handler
on-stop.sh — Stop hook with transcript parsing for last query/response
on-notification.sh — Idle prompt notification
on-permission-request.sh — Tool permission request with human-readable summary
on-prompt-submit.sh — Prompt submission status update
on-post-tool-use.sh — Post-tool-use status update

Requirements

Warp terminal with cli-agent protocol support
jq for JSON payload construction

---name: cursor-plugin-warpdescription: Warp terminal integration for Claude Code — native notifications via OSC 777 escape sequences. Hooks into SessionStart, Stop, Notification, PermissionRequest, UserPromptSubmit, and PostToolUse lifecycle events. Sends structured JSON payloads to Warp for session status, idle prompts, permission requests, and task completion.---# Warp Terminal IntegrationNative Warp terminal notifications for Claude Code sessions. Uses OSC 777 escapesequences to send structured JSON payloads to Warp's cli-agent notification system.## Hooks| Hook | Trigger | Purpose ||------|---------|---------|| SessionStart | startup, resume | Emit plugin version, detect Warp || Stop | session end | Notify task completion with last query/response || Notification | idle_prompt | Alert when Claude is idle and waiting for input || PermissionRequest | tool approval | Notify when Claude needs permission to run a tool || UserPromptSubmit | prompt sent | Transition session status back to running || PostToolUse | tool complete | Transition session from blocked back to running |## ProtocolPayloads follow the cli-agent notification schema with version negotiation:```json{ "v": 1, "agent": "claude", "event": "stop|session_start|idle_prompt|permission_request|prompt_submit|tool_complete", "session_id": "...", "cwd": "...", "project": "..."}```The `should-use-structured.sh` guard checks `WARP_CLI_AGENT_PROTOCOL_VERSION` and`WARP_CLIENT_VERSION` to avoid sending structured notifications to Warp builds thatadvertise protocol support but cannot render them.## Scripts- `build-payload.sh` — Shared payload builder with protocol version negotiation- `should-use-structured.sh` — Feature detection for structured notification support- `warp-notify.sh` — OSC 777 escape sequence emitter to `/dev/tty`- `on-session-start.sh` — SessionStart hook handler- `on-stop.sh` — Stop hook with transcript parsing for last query/response- `on-notification.sh` — Idle prompt notification- `on-permission-request.sh` — Tool permission request with human-readable summary- `on-prompt-submit.sh` — Prompt submission status update- `on-post-tool-use.sh` — Post-tool-use status update## Requirements- Warp terminal with cli-agent protocol support- `jq` for JSON payload construction

Frequently asked questions