Skip to content

Commit 26ef589

Browse files
zachlloydwarp-agent
andcommitted
Add SessionStart hook for welcome message and restart guidance
- Add on-session-start.sh that detects Warp terminal and shows appropriate message - Add SessionStart hook to hooks.json - Update README with restart requirement note - Bump version to 1.1.0 Co-Authored-By: Warp <agent@warp.dev>
1 parent 1ef544a commit 26ef589

5 files changed

Lines changed: 38 additions & 4 deletions

File tree

.claude-plugin/marketplace.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
"name": "warp",
1111
"description": "Native Warp notifications when Claude completes tasks or needs input",
1212
"source": "./plugins/warp",
13-
"version": "1.0.0",
13+
"version": "1.1.0",
1414
"category": "productivity",
1515
"tags": ["notifications", "terminal", "warp"]
1616
}

README.md

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,9 @@ Notifications appear in Warp's notification center and as system notifications,
2727
/plugin install warp@claude-code-warp
2828
```
2929

30-
That's it! Notifications will appear automatically when Claude completes tasks.
30+
> ⚠️ **Important**: After installing, **restart Claude Code** for notifications to activate.
31+
32+
Once restarted, you'll see a confirmation message and notifications will appear automatically when Claude completes tasks.
3133

3234
## Requirements
3335

@@ -43,7 +45,8 @@ This plugin uses Warp's [pluggable notifications](https://docs.warp.dev/features
4345
2. Formats a concise notification message
4446
3. Sends an OSC 777 escape sequence to Warp, which displays a native notification
4547

46-
The plugin registers two hooks:
48+
The plugin registers three hooks:
49+
- **SessionStart** — shows a welcome message confirming the plugin is active
4750
- **Stop** — fires when Claude finishes responding
4851
- **Notification** — fires when Claude needs user input
4952

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "warp",
33
"description": "Warp terminal integration for Claude Code - native notifications, and more to come",
4-
"version": "1.0.1",
4+
"version": "1.1.0",
55
"author": {
66
"name": "Warp",
77
"url": "https://warp.dev"

plugins/warp/hooks/hooks.json

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,17 @@
11
{
22
"description": "Warp terminal notifications",
33
"hooks": {
4+
"SessionStart": [
5+
{
6+
"matcher": "startup",
7+
"hooks": [
8+
{
9+
"type": "command",
10+
"command": "${CLAUDE_PLUGIN_ROOT}/scripts/on-session-start.sh"
11+
}
12+
]
13+
}
14+
],
415
"Stop": [
516
{
617
"hooks": [
Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
#!/bin/bash
2+
# Hook script for Claude Code SessionStart event
3+
# Shows welcome message and Warp detection status
4+
5+
# Check if running in Warp terminal
6+
if [ "$TERM_PROGRAM" = "WarpTerminal" ]; then
7+
# Running in Warp - notifications will work
8+
cat << 'EOF'
9+
{
10+
"systemMessage": "🔔 Warp plugin active. You'll receive native Warp notifications when tasks complete or input is needed."
11+
}
12+
EOF
13+
else
14+
# Not running in Warp - suggest installing
15+
cat << 'EOF'
16+
{
17+
"systemMessage": "ℹ️ Warp plugin installed but you're not running in Warp terminal. Install Warp (https://warp.dev) to get native notifications when Claude completes tasks or needs input."
18+
}
19+
EOF
20+
fi

0 commit comments

Comments
 (0)