Claude Code Toast

claude-code-toast

Custom glassmorphism toast notifications for Claude Code on WSL2.

Get notified when Claude finishes a task — with project name, elapsed time, and a summary of what was done.

Features

- Glassmorphism design — semi-transparent background, rounded corners, fade animations
- Elapsed time tracking — color-coded timer badge shows how long each task took
- Message preview — shows Claude's last response or notification content
- Non-intrusive — doesn't steal focus, click to dismiss, auto-dismiss with progress bar
- DPI-aware — scales properly on high-DPI displays
- Themes — 4 built-in themes (claude, github, minimal, midnight)
- Configurable — duration, position, opacity, sound, minimum elapsed threshold
- Smart filtering — skip notifications for quick tasks under your threshold

Events

Requirements

- WSL2 on Windows 10/11 (Windows 11 recommended for rounded corners + acrylic)
- Bun runtime
- PowerShell (available by default via powershell.exe)

Install

The installer:
1. Adds hooks to ~/.claude/settings.json
2. Creates default config at ~/.claude/ccnotify/config.json
3. Shows a test notification to confirm it works

Restart Claude Code after installing.

Uninstall

Your config is preserved at ~/.claude/ccnotify/config.json.

Test

Configuration

Edit ~/.claude/ccnotify/config.json:

Themes

How it works

The toast uses WS_EX_NOACTIVATE | WS_EX_TOOLWINDOW so it never steals focus. On Windows 11, it uses DWM attributes for native rounded corners and dark title bar. On Windows 10, it falls back to GDI+ rounded rectangles with opacity.

License

MIT