Ghostty Tmux Claude Notifications

ghostty-tmux-claude-notifications.txt

#!/bin/bash
# Sends an OSC 777 notification to the parent Ghostty terminal via tmux passthrough.
# Walks up the process tree to find the TTY since hooks have no controlling terminal.
#
# Based on: https://github.com/recursechat/agent-workflow/blob/main/ghostty-tab-notifications.md
#
# Expanded on by: https://github.com/scarrillo && Claude
# - Tmux support
# - Requires: tmux `set -g allow-passthrough on`
# - You can set and reload Tmux without interrupting your active sessions.
# - This Gist: https://gist.github.com/scarrillo/1668e3213a6066c9bda680a3e27be231
#
# Claude Code hook config (~/.claude/settings.json):
#   Use separate matchers per notification type to pass emoji + message as $1.
#   "Notification": [
#     { "matcher": "permission_prompt",  "hooks": [{ "type": "command", "command": "~/.claude/hooks/ghostty-notify.sh '🔐 Needs permission'" }] },
#     { "matcher": "idle_prompt",        "hooks": [{ "type": "command", "command": "~/.claude/hooks/ghostty-notify.sh '😴 Waiting for input'" }] },
#     { "matcher": "auth_success",       "hooks": [{ "type": "command", "command": "~/.claude/hooks/ghostty-notify.sh '✅ Auth successful'" }] },
#     { "matcher": "elicitation_dialog", "hooks": [{ "type": "command", "command": "~/.claude/hooks/ghostty-notify.sh '💬 Asking a question'" }] }
#   ]

MSG="${1:-🤖 needs you.}"

# Walk up process tree to find an ancestor with a real TTY
PID=$$
TTY=""
while [ "$PID" != "1" ] && [ -n "$PID" ]; do
  T=$(ps -o tty= -p "$PID" 2>/dev/null | tr -d ' ')
  if [ -n "$T" ] && [ "$T" != "??" ] && [ -e "/dev/$T" ]; then
    TTY="/dev/$T"
    break
  fi
  PID=$(ps -o ppid= -p "$PID" 2>/dev/null | tr -d ' ')
done

if [ -z "$TTY" ]; then
  exit 0
fi

# Build subtitle from tmux context
SUBTITLE=$(tmux display-message -p '#{window_name}: #{b:pane_current_path}' 2>/dev/null)

# Set window title and send notification in one write to avoid Claude Code overwriting title
if [ -n "$SUBTITLE" ]; then
  printf '\ePtmux;\e\e]0;%s\007\e\\\ePtmux;\e\e]777;notify;Claude;%s\007\e\\' "$SUBTITLE" "$MSG" > "$TTY"
else
  printf '\ePtmux;\e\e]777;notify;Claude;%s\007\e\\' "$MSG" > "$TTY"
fi

exit 0