Initial commit: Warp plugin for Claude Code notifications

Adds native Warp terminal notifications when Claude Code completes tasks
or needs user input. Notifications include the original prompt and
Claude's response for quick context.

Co-Authored-By: Warp <agent@warp.dev>

Author: zachlloyd

.claude-plugin/marketplace.json

@@ -0,0 +1,18 @@
+{
+  "name": "claude-code-warp",
+  "description": "Official Warp terminal integrations for Claude Code",
+  "owner": {
+    "name": "Warp",
+    "url": "https://warp.dev"
+  },
+  "plugins": [
+    {
+      "name": "warp",
+      "description": "Native Warp notifications when Claude completes tasks or needs input",
+      "source": "./plugins/warp",
+      "version": "1.0.0",
+      "category": "productivity",
+      "tags": ["notifications", "terminal", "warp"]
+    }
+  ]
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Warp
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,74 @@
+# Claude Code + Warp
+
+Official [Warp](https://warp.dev) terminal integration for [Claude Code](https://docs.anthropic.com/en/docs/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 requires approval or has a question
+
+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.
+
+**Example notification:**
+```
+"what's 1+1" → 2
+```
+
+## Installation
+
+```bash
+# In Claude Code, add the marketplace
+/plugin marketplace add warpdotdev/claude-code-warp
+
+# Install the Warp plugin
+/plugin install warp@claude-code-warp
+```
+
+That's it! Notifications will appear automatically when Claude completes tasks.
+
+## Requirements
+
+- [Warp terminal](https://warp.dev) (macOS, Linux, or Windows)
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI
+- `jq` for JSON parsing (install via `brew install jq` or your package manager)
+
+## How It Works
+
+This plugin uses Warp's [pluggable notifications](https://docs.warp.dev/features/notifications) feature via OSC escape sequences. When Claude Code triggers a hook event, the plugin:
+
+1. Reads the session transcript to extract your original prompt and Claude's response
+2. Formats a concise notification message
+3. Sends an OSC 777 escape sequence to Warp, which displays a native notification
+
+The plugin registers two hooks:
+- **Stop** — fires when Claude finishes responding
+- **Notification** — fires when Claude needs user input
+
+## Configuration
+
+Notifications work out of the box. To customize Warp's notification behavior (sounds, system notifications, etc.), see [Warp's notification settings](https://docs.warp.dev/features/notifications).
+
+## Roadmap
+
+Future Warp integrations planned:
+- Warp AI context sharing
+- Warp Drive integration for sharing Claude Code configurations
+- Custom slash commands
+
+## Uninstall
+
+```bash
+/plugin uninstall warp@claude-code-warp
+/plugin marketplace remove claude-code-warp
+```
+
+## Contributing
+
+Contributions welcome! Please open an issue or PR on [GitHub](https://github.com/warpdotdev/claude-code-warp).
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

plugins/warp/.claude-plugin/plugin.json

@@ -0,0 +1,10 @@
+{
+  "name": "warp",
+  "description": "Warp terminal integration for Claude Code - native notifications, and more to come",
+  "version": "1.0.1",
+  "author": {
+    "name": "Warp",
+    "url": "https://warp.dev"
+  },
+  "homepage": "https://github.com/warpdotdev/claude-code-warp"
+}

plugins/warp/hooks/hooks.json

@@ -0,0 +1,26 @@
+{
+  "description": "Warp terminal notifications",
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/on-stop.sh"
+          }
+        ]
+      }
+    ],
+    "Notification": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/on-notification.sh"
+          }
+        ]
+      }
+    ]
+  }
+}

plugins/warp/scripts/on-notification.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+# Hook script for Claude Code Notification event
+# Sends a Warp notification when Claude needs user input
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Read hook input from stdin
+INPUT=$(cat)
+
+# Extract the notification message
+MSG=$(echo "$INPUT" | jq -r '.message // "Input needed"' 2>/dev/null)
+[ -z "$MSG" ] && MSG="Input needed"
+
+"$SCRIPT_DIR/warp-notify.sh" "Claude Code" "$MSG"

plugins/warp/scripts/on-stop.sh

@@ -0,0 +1,48 @@
+#!/bin/bash
+# Hook script for Claude Code Stop event
+# Sends a Warp notification when Claude completes a task
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Read hook input from stdin
+INPUT=$(cat)
+
+# Extract transcript path from the hook input
+TRANSCRIPT_PATH=$(echo "$INPUT" | jq -r '.transcript_path // empty' 2>/dev/null)
+
+# Default message
+MSG="Task completed"
+
+# Try to extract prompt and response from the transcript (JSONL format)
+if [ -n "$TRANSCRIPT_PATH" ] && [ -f "$TRANSCRIPT_PATH" ]; then
+    # Get the first user prompt
+    PROMPT=$(jq -rs '
+        [.[] | select(.type == "user")] | first | .message.content // empty
+    ' "$TRANSCRIPT_PATH" 2>/dev/null)
+    
+    # Get the last assistant response
+    RESPONSE=$(jq -rs '
+        [.[] | select(.type == "assistant" and .message.content)] | last |
+        [.message.content[] | select(.type == "text") | .text] | join(" ")
+    ' "$TRANSCRIPT_PATH" 2>/dev/null)
+    
+    if [ -n "$PROMPT" ] && [ -n "$RESPONSE" ]; then
+        # Truncate prompt to 50 chars
+        if [ ${#PROMPT} -gt 50 ]; then
+            PROMPT="${PROMPT:0:47}..."
+        fi
+        # Truncate response to 120 chars
+        if [ ${#RESPONSE} -gt 120 ]; then
+            RESPONSE="${RESPONSE:0:117}..."
+        fi
+        MSG="\"${PROMPT}\" → ${RESPONSE}"
+    elif [ -n "$RESPONSE" ]; then
+        # Fallback to just response if no prompt found
+        if [ ${#RESPONSE} -gt 175 ]; then
+            RESPONSE="${RESPONSE:0:172}..."
+        fi
+        MSG="$RESPONSE"
+    fi
+fi
+
+"$SCRIPT_DIR/warp-notify.sh" "Claude Code" "$MSG"

plugins/warp/scripts/warp-notify.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+# Warp notification utility using OSC escape sequences
+# Usage: warp-notify.sh <title> <body>
+
+TITLE="${1:-Notification}"
+BODY="${2:-}"
+
+# OSC 777 format: \033]777;notify;<title>;<body>\007
+# Write directly to /dev/tty to ensure it reaches the terminal
+printf '\033]777;notify;%s;%s\007' "$TITLE" "$BODY" > /dev/tty 2>/dev/null || true