setup-notification

Installation
SKILL.md

Setup Notification Hooks

This is a setup skill: it does not run on events itself. It installs hook scripts (shipped alongside this skill) into the user's Claude Code settings.json so the harness fires them on Stop and Notification events.

What it sets up

  • Stop → scripts/stop-speak.sh: speaks "Task completed" and shows a macOS dialog (session / window / dir / branch). Clicking Go refocuses the originating terminal (tmux-aware).
  • Notification (permission_prompt, idle_prompt) → scripts/notification-hook.sh: speaks "Permission needed" / "Waiting for input" and shows a warning alert with the same Go behavior.
  • TTS uses edge-tts (voice en-US-AriaNeural) when available, falling back to macOS say.

Requirements

  • macOS (uses osascript, say, afplay)
  • jq (scripts parse hook stdin JSON)
  • Optional: edge-tts for nicer TTS (pipx install edge-tts); without it, say is used.

Steps

1. Resolve this skill's absolute scripts path

Installs
3
GitHub Stars
14
First Seen
Jun 10, 2026