claude-hook-notify-setup

Connect native OS toast notifications to Claude Code hooks.

1|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/dev-goraebap/grimoire --skill claude-hook-notify-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-hook-notify-setup
Source: https://github.com/dev-goraebap/grimoire/tree/main/misc/skills/claude-hook-notify-setup
Command: npx skills add https://github.com/dev-goraebap/grimoire --skill claude-hook-notify-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Claude Code workflows often miss updates because there is no native OS toast notification. This skill connects OS-level alerts to Claude Code, ensuring you notice completions, permission prompts, and important system messages.

Core Features & Use Cases

  • Cross-platform notifications on Stop, PermissionRequest, and Notification hooks using node-notifier (Windows, macOS, Linux).
  • Simple setup: install scripts and assets, and configure hooks to display toast messages for key events.
  • Real-world use: receive a desktop toast when a long-running Claude Code task finishes or when a tool requests permission.

Quick Start

Install the skill, configure your environment, and trigger a test Stop event to see a completion toast.

Frequently Asked Questions about claude-hook-notify-setup

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

FAQPage Schema
How do I get desktop toast notifications when Claude Code tasks finish?

Desktop toast notifications for Claude Code are triggered by connecting OS-level alerts to Claude Code hooks. This skill uses node-notifier to dispatch contextual toasts for Stop, PermissionRequest, and Notification events.

Can I receive OS toast alerts for Claude Code permission requests on Windows, macOS, and Linux?

Yes, OS toast alerts for Claude Code hooks support cross-platform notifications on Windows, macOS, and Linux. It relies on node-notifier to ensure consistent alerts during permission requests and system prompts.

How do I set up Claude Code hooks to show desktop alerts?

Setting up Claude Code hooks for desktop alerts involves installing the provided integration scripts and assets, then configuring the hooks to display toast messages for key events like task completion or tool permission requests.

What is the best way to monitor long-running Claude Code tasks without watching the terminal?

The best way to monitor long-running Claude Code tasks is by configuring Stop hooks to dispatch OS toast notifications. This ensures you receive a desktop alert when a background task finishes processing.

Do I need node-notifier to enable toast notifications for Claude Code hooks?

Yes, node-notifier is a required dependency to enable toast notifications for Claude Code hooks. It provides the cross-platform functionality needed to dispatch OS-level desktop alerts.

Why am I missing Claude Code updates when running background commands?

You miss Claude Code updates because there is no native OS toast notification connected to your workflow. Linking OS-level alerts to Claude Code hooks ensures you notice completions, permission prompts, and system messages.