Claude Code macOS notifications via hooks (permission prompts, questions, and completion)

notify-done.sh

#!/bin/bash
set -euo pipefail

INPUT="$(cat)"

# Skip if this is a subagent stopping, not the main agent
AGENT_ID="$(echo "$INPUT" | jq -r '.agent_id // empty')"
if [[ -n "$AGENT_ID" ]]; then
  exit 0
fi

CWD="$(echo "$INPUT" | jq -r '.cwd // ""')"
PROJECT="$(basename "$CWD")"

terminal-notifier \
  -title "Claude Code — $PROJECT" \
  -message "Done" \
  -sound Glass >/dev/null 2>&1

notify-needs-attention.sh

#!/bin/bash
set -eo pipefail

INPUT="$(cat)"
CWD="$(echo "$INPUT" | jq -r '.cwd // ""')"
PROJECT="$(basename "$CWD")"

terminal-notifier \
  -title "Claude Code — $PROJECT" \
  -message "Claude is asking a question" \
  -sound Glass >/dev/null 2>&1

notify-permission.sh

#!/bin/bash
set -eo pipefail

INPUT="$(cat)"
CWD="$(echo "$INPUT" | jq -r '.cwd // ""')"
PROJECT="$(basename "$CWD")"
MESSAGE="$(echo "$INPUT" | jq -r '.message // "Waiting for permission"')"

terminal-notifier \
  -title "Claude Code — $PROJECT" \
  -message "$MESSAGE" \
  -sound Glass >/dev/null 2>&1

settings.json

{
  "permissions": {
    "allow": []
  },
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "AskUserQuestion",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/notify-needs-attention.sh"
          }
        ]
      }
    ],
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/notify-permission.sh"
          }
        ]
      }
    ],
    "PermissionRequest": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/notify-permission.sh"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "~/.claude/hooks/notify-done.sh"
          }
        ]
      }
    ]
  }
}