skills.rest
sizukutamago
sizukutamagoCOMMUNITY
Explore all skills by this author →
GitHub

notify-hooks

Automate macOS notifications for Claude Code task lifecycle via Stop and Notification hooks.

Updated Feb 4, 2026
Search Tags:#automation#hooks#Claude Code#macOS#notifications#terminal-notifier
One-click install
npx skills add https://github.com/sizukutamago/dev-tools-plugin --skill notify-hooks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notify-hooks
Source: https://github.com/sizukutamago/dev-tools-plugin/tree/main/skills/notify-hooks
Command: npx skills add https://github.com/sizukutamago/dev-tools-plugin --skill notify-hooks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires terminal-notifier, and includes scripts (resource) components.

What problem does it solve?

This Skill ensures timely macOS notifications for Claude Code task events, eliminating the need to manually monitor progress during automation workflows.

Core Features & Use Cases

  • Automatic Stop and Notification hook alerts when a task completes or requires permission.
  • Click-to-focus: clicking a notification activates the Terminal application and highlights the relevant window or pane.
  • Works with Terminal.app and iTerm2, with a robust fallback to osascript when terminal-notifier is unavailable.

Quick Start

Install terminal-notifier (e.g., brew install terminal-notifier), place this skill under your plugin directory, and ensure CLAUDE_NOTIFY is enabled. Then configure the notification sound with CLAUDE_NOTIFY_SOUND if desired and use the provided scripts to trigger notifications from Claude Code events.

Frequently Asked Questions about notify-hooks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get macOS notifications when Claude Code tasks finish?▼

You can get macOS notifications for Claude Code by automating task lifecycle events with Stop and Notification hooks. This triggers alerts when a task completes or requires permission, eliminating manual progress monitoring.

Do I need terminal-notifier to send macOS alerts from Claude Code?▼

terminal-notifier is the preferred backend for sending macOS alerts, but not strictly required. The system uses osascript as a fallback for click-to-focus integration when terminal-notifier is unavailable.

Can I use Claude Code notification hooks with iTerm2?▼

Claude Code notification hooks work with both Terminal.app and iTerm2 environments. Clicking a notification activates the terminal application and highlights the relevant window or pane.

How to configure custom notification sounds for Claude Code hooks?▼

Configure custom notification sounds by setting the CLAUDE_NOTIFY_SOUND environment variable. Ensure CLAUDE_NOTIFY is enabled to activate the alert system across your terminal sessions.

Why does clicking a Claude Code macOS notification not focus my terminal?▼

Click-to-focus requires proper terminal integration. If terminal-notifier is unavailable, the system falls back to osascript to activate the Terminal application and highlight the relevant window.

Related Skills

Explore More Software Engineering Skills→
harnessprotocolharnessprotocol
9

iterm-notify

Send macOS desktop notifications and manage iTerm2 badges for Claude Code lifecycle events.

Official
Basic
xtrm-devxtrm-dev
4

hook-development

Build and validate Claude Code plugin hooks for event-driven automation.

Official
Advanced
julianobarbosajulianobarbosa
7

Iterm2

Manage iTerm2 and tmux workflows with native -CC integration.

Community
Intermediate
mikeyobrienmikeyobrien
369

notification

Display native macOS notifications with title, message, and optional sound.

Community
Basic