Claude Code Notify

🔔 Claude Code Notify

Native Windows Toast notifications for Claude Code

📖 中文文档

*Click the notification to jump back to your Claude Code window*

✨ Features

- 🔔 Native Windows Toast — Clean, system-integrated notifications
- 🎯 One-Click Return — Click to jump back to your terminal/editor
- 🖥️ Wide Compatibility — VSCode, Cursor, JetBrains, Windows Terminal, and more
- 🔄 Tab-Aware — Supports Windows Terminal tab switching
- 🎨 Auto Icon — Extracts the calling application's icon

🚀 Installation

That's it. Restart Claude Code and notifications will work automatically.

WSL Permission Fix

If you install the plugin inside WSL and hooks fail with Permission denied, make the bundled Windows executable runnable:

This is the workaround from issue #2. If your cache path uses a fixed version directory, * can be replaced with that version, for example 1.1.0.

📖 Usage

After Claude finishes responding, a notification appears:

🗑️ Uninstall

⚙️ How It Works

Plugin System

This project uses Claude Code's plugin system to register hooks automatically — no manual settings.json editing required. Hooks are defined in hooks/hooks.json and discovered by Claude Code at startup.

Hook Flow

Session Isolation

Each Claude Code session has a unique session_id (received via stdin JSON). State is stored per-session in %TEMP%\claude-notify-{session_id}.txt, so multiple Claude instances don't interfere with each other.

Windows Terminal Tab Switching

When running inside Windows Terminal, simply bringing the window to the foreground isn't enough — the user may have switched to a different tab. This project uses the Windows UI Automation API to:

1. Detect if the foreground window is Windows Terminal (by checking for the CASCADIA_HOSTING_WINDOW_CLASS window class)
2. Enumerate all…