Install this Claude Code hook.
Name: iMessage Notify on Complete
Save to: ~/.claude/hooks/imessage-notify-on-complete.sh
Make executable: yes

---
#!/usr/bin/env bash
# Hook type: Stop
# Trigger: When Claude Code completes a session or long task
#
# Sends an iMessage to a configured phone number when Claude finishes.
# macOS only — uses AppleScript to send via Messages.app.
#
# Place this in your hooks config:
#   hooks:
#     Stop:
#       - matcher: ""
#         hooks:
#           - type: command
#             command: /path/to/imessage-notify.sh

set -euo pipefail

# ── Configuration ─────────────────────────────────────────────────────────────
NOTIFY_NUMBER="${IMESSAGE_NOTIFY_NUMBER:-+1XXXXXXXXXX}"  # set in env or edit here
# ──────────────────────────────────────────────────────────────────────────────

# Read the stop reason from stdin (JSON)
INPUT=$(cat)
REASON=$(echo "$INPUT" | python3 -c "
import sys, json
d = json.load(sys.stdin)
print(d.get('stop_reason', 'completed'))
" 2>/dev/null || echo "completed")

MESSAGE="Claude Code has finished ($REASON)."

# Send via AppleScript
osascript -e "
tell application \"Messages\"
    set targetService to 1st account whose service type = iMessage
    set targetBuddy to participant \"$NOTIFY_NUMBER\" of targetService
    send \"$MESSAGE\" to targetBuddy
end tell
" 2>/dev/null

# Fallback: if Messages.app isn't available, try terminal-notifier
if [ $? -ne 0 ] && command -v terminal-notifier &>/dev/null; then
  terminal-notifier -title "Claude Code" -message "$MESSAGE"
fi