cctoast-wsl

cctoast-wsl
Secure, zero-admin utility that enables Windows toast notifications from WSL for Claude Code hooks using PowerShell's BurntToast module.

Transform your Claude Code workflow with native Windows notifications that appear when Claude is waiting for input or completes tasks - all from within WSL with no system-level changes required.

Demo

Animated demos coming soon - GIF recordings of toast notifications and CLI installation will be added in a future release

  Product Demo

How It Works

Quick Start

Get Windows toast notifications working in under 2 minutes:

1. Install: npx @claude/cctoast-wsl
2. Test: Run Claude Code - notifications appear automatically
3. Done: Toast notifications now work from WSL!

Installation completes in under 30 seconds and requires no admin privileges. BurntToast PowerShell module is automatically installed if needed (user consent required).

One-line installation

  CLI Installer Demo

CLI Reference

Complete list of available flags and options:

Defaults: Global installation + both hooks enabled + no sync
Exit codes: 0 success · 1 abort · 2 dependency failure · 3 I/O error
Interactive flow: scope → hooks → sync → confirm

Common usage examples

Manual Installation

* Only place the script outside your project directory, for security. Executable hook files in project directories (editable by Claude Code) pose risks including from prompt injection.
* Never use sudo in hook commands/scripts. This will cause the script to run as root, which is a security risk.

1. Download the script:

2. Add to Claude settings:
   Edit ~/.claude/settings.json:

Troubleshooting

Quick fixes for common issues

❌ "PowerShell execution policy" error

❌ "BurntToast module not found"

❌ No notifications appearing
1. Check that you're in WSL: echo…