claude-code-toast

Windows toast notifications for Claude Code events using native Windows APIs.

Features

• Notification Hook: Shows a toast notification when Claude Code sends notifications (e.g., asking for input, tool permission requests)
• Stop Hook: Shows a toast when Claude Code finishes responding

Prerequisites

• Windows 10/11
• PowerShell 5.1+

No external modules required - uses native Windows toast notification APIs.

Installation

Option 1: Via Plugin Marketplace (Recommended)

First, add the marketplace:

/plugin marketplace add TianqiZhang/claude-code-toast

Then install the plugin:

/plugin install toast-notifications@claude-code-toast

Option 2: Direct Plugin Install

/plugin install TianqiZhang/claude-code-toast

Option 3: Local Installation (for development)

/plugin marketplace add /path/to/claude-code-toast
/plugin install toast-notifications@claude-code-toast

Usage

Once installed, the plugin automatically:

1. Shows a toast notification when Claude Code needs your attention
2. Shows a "Finished responding" toast when Claude completes a response

Hook Events

Event	Description
Notification	Triggered when Claude Code sends a notification
Stop	Triggered when Claude Code finishes responding

Project Structure

claude-code-toast/
├── .claude-plugin/
│   ├── plugin.json             # Plugin manifest
│   └── marketplace.json        # Marketplace manifest
├── assets/
│   └── icon.png                # Notification icon
├── hooks/
│   └── hooks.json              # Hook configuration
├── scripts/
│   ├── toast-notification.ps1  # Notification handler
│   └── toast-stop.ps1          # Stop event handler
├── LICENSE
└── README.md

Testing

# Test notification toast
'{"message": "Test notification", "notification_type": "info"}' | powershell -File .\scripts\toast-notification.ps1

# Test stop toast
powershell -File .\scripts\toast-stop.ps1

License

MIT