Claude Code Warp

Claude Code + Warp

Official Warp terminal integration for Claude Code.

Features

🔔 Native Notifications

Get native Warp notifications when Claude Code:
- Completes a task — with a summary showing your prompt and Claude's response
- Needs your input — when Claude is waiting for you, including background agents
- Requests permission — when Claude wants to run a tool and needs your approval

Notifications appear in Warp's notification center and as system notifications, so you can context-switch while Claude works and get alerted when attention is needed.

📡 Session Status

The plugin keeps Warp informed of Claude's current state by emitting structured events on every session transition:
- Prompt submitted — you sent a prompt, Claude is working
- Tool completed — a tool call finished, Claude is back to running

This powers Warp's inline status indicators for Claude Code sessions.

Installation
⚠️ Important: After installing, restart Claude Code or run /reload-plugins for the plugin to activate.

Once restarted, you'll see a confirmation message and notifications will appear automatically.

Requirements

- Warp terminal (macOS, Linux, or Windows)
- Claude Code CLI
- jq for JSON parsing (install via brew install jq or your package manager)

How It Works

The plugin communicates with Warp via OSC 777 escape sequences. Each hook script builds a structured JSON payload (via build-payload.sh) and sends it to warp://cli-agent, where Warp parses it to drive notifications and session UI.

Payloads include a protocol version negotiated between the plugin and Warp (min(plugin_version, warp_version)), the session ID, working directory, and event-specific fields.

The plugin registers lifecycle hooks including:
- SessionStart — emits the plugin version and a welcome system…