feat: add Claude event alert hooks

Author: mylee04

README.md

@@ -13,19 +13,19 @@ Desktop notifications for AI coding tools - get alerts when tasks complete or in
   <img src="assets/multi-tools-support-02.png" width="48%" alt="All tools enabled"/>
 </p>
 
-[![Version](https://img.shields.io/badge/version-1.7.3-blue.svg)](https://github.com/mylee04/code-notify/releases)
+[![Version](https://img.shields.io/badge/version-1.7.4-blue.svg)](https://github.com/mylee04/code-notify/releases)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![macOS](https://img.shields.io/badge/macOS-supported-green.svg)](https://www.apple.com/macos)
 [![Linux](https://img.shields.io/badge/Linux-supported-green.svg)](https://www.linux.org/)
 [![Windows](https://img.shields.io/badge/Windows-supported-green.svg)](https://www.microsoft.com/windows)
 
 ---
 
-## What's New in v1.7.3
+## What's New in v1.7.4
 
-- **Claude hook detection is stricter now**: `cn on claude` no longer treats arbitrary `Notification` or `Stop` entries as if code-notify were already installed
-- **Existing Claude hooks are preserved**: enabling or disabling code-notify now adds or removes only the managed Claude Notification/Stop commands instead of overwriting unrelated hooks
-- **Unix and Windows Claude config behavior stay aligned**: both runtimes now preserve custom hook entries and have regression coverage for the merge/remove path
+- **Claude agent/team event alerts**: `cn alerts` can now opt into `SubagentStop`, `TeammateIdle`, `TaskCompleted`, and related Claude hook events
+- **Less noisy subagent workflows**: Claude event hooks get their own rate-limit bucket via `CODE_NOTIFY_EVENT_RATE_LIMIT_SECONDS`
+- **npm package metadata fixed**: npm global install now keeps the `cn`, `cnp`, and `code-notify` binaries when published
 
 ---
 
@@ -156,6 +156,14 @@ When enabled, it adds hooks that call the notification script when tasks complet
           { "type": "command", "command": "notify.sh notification claude" }
         ]
       }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "",
+        "hooks": [
+          { "type": "command", "command": "notify.sh SubagentStop claude" }
+        ]
+      }
     ]
   }
 }
@@ -170,18 +178,26 @@ By default, notifications only fire when the AI is idle and waiting for input (`
 ```bash
 cn alerts                          # Show current config
 cn alerts add permission_prompt    # Also notify on tool permission requests
+cn alerts add SubagentStop         # Also notify when Claude subagents finish
 cn alerts remove permission_prompt # Remove permission notifications
 cn alerts reset                    # Back to default (idle_prompt only)
 ```
 
-| Type                 | Description                            |
-| -------------------- | -------------------------------------- |
-| `idle_prompt`        | AI is waiting for your input (default) |
-| `permission_prompt`  | AI needs tool permission (Y/n)         |
-| `auth_success`       | Authentication success                 |
-| `elicitation_dialog` | MCP tool input needed                  |
+| Type                 | Description                                    |
+| -------------------- | ---------------------------------------------- |
+| `idle_prompt`        | AI is waiting for your input (default)         |
+| `permission_prompt`  | AI needs tool permission (Y/n)                 |
+| `auth_success`       | Authentication success                         |
+| `elicitation_dialog` | MCP tool input needed                          |
+| `SubagentStart`      | Claude subagent started                        |
+| `SubagentStop`       | Claude subagent completed                      |
+| `TeammateIdle`       | Claude teammate is waiting for input           |
+| `TaskCreated`        | Claude agent-team task was created             |
+| `TaskCompleted`      | Claude agent-team task completed               |
+
+Alert-type matching applies to Claude Code notification hooks and Gemini CLI notification hooks. Claude Code agent/team events are separate hook events and are opt-in via `cn alerts add SubagentStop`, `cn alerts add TeammateIdle`, or `cn alerts add TaskCompleted`.
 
-Alert-type matching currently applies to Claude Code and Gemini CLI notification hooks. Codex currently uses completion events from `notify`, so `permission_prompt` and `idle_prompt` settings do not change Codex behavior.
+Agent-team and subagent workflows can be noisy if `permission_prompt` is enabled. If you only want idle pings, run `cn alerts remove permission_prompt && cn on`. Codex currently uses completion events from `notify`, so `permission_prompt` and `idle_prompt` settings do not change Codex behavior.
 
 ## Troubleshooting
 

bin/code-notify

@@ -6,7 +6,7 @@
 set -e
 
 # Version
-VERSION="1.7.3"
+VERSION="1.7.4"
 
 # Determine the directory where the script is located (resolve symlinks)
 SCRIPT_PATH="${BASH_SOURCE[0]}"

lib/code-notify/commands/global.sh

@@ -971,7 +971,7 @@ show_alerts_status() {
     echo "  Matcher: ${CYAN}$current${RESET}"
     echo ""
 
-    echo "  Active types:"
+    echo "  Claude Notification subtypes:"
     if is_notify_type_enabled "idle_prompt"; then
         echo "    ${CHECK_MARK} ${GREEN}idle_prompt${RESET} - AI is waiting for your input (60+ sec idle)"
     else
@@ -996,14 +996,48 @@ show_alerts_status() {
         echo "    ${MUTE} ${DIM}elicitation_dialog${RESET}"
     fi
 
+    echo ""
+    echo "  Claude agent/team hook events:"
+    if is_notify_type_enabled "SubagentStart"; then
+        echo "    ${CHECK_MARK} ${GREEN}SubagentStart${RESET} - A Claude subagent started"
+    else
+        echo "    ${MUTE} ${DIM}SubagentStart${RESET}"
+    fi
+
+    if is_notify_type_enabled "SubagentStop"; then
+        echo "    ${CHECK_MARK} ${GREEN}SubagentStop${RESET} - A Claude subagent completed"
+    else
+        echo "    ${MUTE} ${DIM}SubagentStop${RESET}"
+    fi
+
+    if is_notify_type_enabled "TeammateIdle"; then
+        echo "    ${CHECK_MARK} ${GREEN}TeammateIdle${RESET} - A Claude teammate is idle"
+    else
+        echo "    ${MUTE} ${DIM}TeammateIdle${RESET}"
+    fi
+
+    if is_notify_type_enabled "TaskCreated"; then
+        echo "    ${CHECK_MARK} ${GREEN}TaskCreated${RESET} - An agent-team task was created"
+    else
+        echo "    ${MUTE} ${DIM}TaskCreated${RESET}"
+    fi
+
+    if is_notify_type_enabled "TaskCompleted"; then
+        echo "    ${CHECK_MARK} ${GREEN}TaskCompleted${RESET} - An agent-team task completed"
+    else
+        echo "    ${MUTE} ${DIM}TaskCompleted${RESET}"
+    fi
+
     echo ""
     info "Examples:"
     echo "  ${CYAN}cn alerts add permission_prompt${RESET}   # Also notify on tool permission requests"
+    echo "  ${CYAN}cn alerts add SubagentStop${RESET}        # Notify when Claude subagents finish"
     echo "  ${CYAN}cn alerts add auth_success${RESET}        # Also notify on auth success"
     echo "  ${CYAN}cn alerts remove permission_prompt${RESET} # Stop permission notifications"
     echo "  ${CYAN}cn alerts reset${RESET}                   # Back to idle_prompt only"
     echo ""
-    dim "Alert-type matching currently applies to Claude Code and Gemini CLI hooks."
+    dim "Alert-type matching applies to Claude Code and Gemini CLI hooks."
+    dim "Claude agent/team events are separate hooks and are opt-in."
     dim "Codex currently exposes completion events through notify, so permission_prompt/idle_prompt settings do not change Codex behavior."
     echo ""
     dim "After changing, run 'cn on' to apply the new settings."
@@ -1016,23 +1050,28 @@ show_available_alert_types() {
     echo "  ${CYAN}permission_prompt${RESET}  - AI needs tool permission (can be noisy)"
     echo "  ${CYAN}auth_success${RESET}       - Authentication success"
     echo "  ${CYAN}elicitation_dialog${RESET} - MCP tool input needed"
+    echo ""
+    echo "Claude agent/team hook events:"
+    echo "  ${CYAN}SubagentStart${RESET}      - A Claude subagent started"
+    echo "  ${CYAN}SubagentStop${RESET}       - A Claude subagent completed"
+    echo "  ${CYAN}TeammateIdle${RESET}       - A Claude teammate is idle"
+    echo "  ${CYAN}TaskCreated${RESET}        - An agent-team task was created"
+    echo "  ${CYAN}TaskCompleted${RESET}      - An agent-team task completed"
+    echo ""
+    echo "Aliases like ${CYAN}subagent_stop${RESET}, ${CYAN}teammate-idle${RESET}, and ${CYAN}task_completed${RESET} are accepted."
 }
 
 # Add an alert type
 add_alert_type() {
-    local type="$1"
+    local type
+    type="$(normalize_alert_type "$1" 2>/dev/null || true)"
 
-    # Validate type
-    case "$type" in
-        "idle_prompt"|"permission_prompt"|"auth_success"|"elicitation_dialog")
-            ;;
-        *)
-            error "Unknown notification type: $type"
-            echo ""
-            show_available_alert_types
-            return 1
-            ;;
-    esac
+    if [[ -z "$type" ]]; then
+        error "Unknown notification type: $1"
+        echo ""
+        show_available_alert_types
+        return 1
+    fi
 
     if is_notify_type_enabled "$type"; then
         warning "$type is already enabled"
@@ -1047,7 +1086,15 @@ add_alert_type() {
 
 # Remove an alert type
 remove_alert_type() {
-    local type="$1"
+    local type
+    type="$(normalize_alert_type "$1" 2>/dev/null || true)"
+
+    if [[ -z "$type" ]]; then
+        error "Unknown notification type: $1"
+        echo ""
+        show_available_alert_types
+        return 1
+    fi
 
     if ! is_notify_type_enabled "$type"; then
         warning "$type is not currently enabled"
@@ -1084,6 +1131,7 @@ show_alerts_help() {
     echo "Examples:"
     echo "  cn alerts                        # Show current config"
     echo "  cn alerts add permission_prompt  # Also notify on permission requests"
+    echo "  cn alerts add SubagentStop       # Also notify when Claude subagents finish"
     echo "  cn alerts remove permission_prompt"
     echo "  cn alerts reset                  # Back to idle_prompt only"
 }