prompt-chime

Cross-platform notification toolkit for AI coding assistants. Get alerted when prompts complete with customizable sounds, toast notifications, profiles, and quiet hours.
Features
- **Cross-platform** — Windows, macOS, Linux
- **Bundled sounds** — 4 generated WAV tones (default, success, error, gentle)
- **Meme sound presets** — 11 chiptune sounds (Mario 1-Up, Zelda secret, Metal Gear alert, etc.)
- **Custom sounds** — drop .wav/.mp3 files in sounds/custom/
- **Profiles** — switch between sound presets (default, silent, loud, or create your own)
- **Per-project overrides** — different sounds per workspace
- **Quiet hours** — auto-mute during specified time ranges (supports overnight wrap)
- **Toast notifications** — native OS popups (WinRT on Windows 10+, osascript on macOS, notify-send on Linux)
- **Volume control** — global volume 0-100%
- **Zero dependencies** — uses OS built-in tools only (python3 optional for config editing)
Prerequisites
| OS | Required | Optional |
|----|----------|----------|
| **Windows** | Git Bash, PowerShell | python3 (for manage.sh and meme sounds) |
| **macOS** | bash | afplay, osascript, python3 |
| **Linux** | bash | paplay/aplay/pw-play, notify-send, python3 |
Installation
Via Claude Code (Recommended)
The plugin registers the Stop hook automatically — you'll hear a notification every time Claude finishes responding.
Via CLI
This copies files to ~/.claude/notifications/ and registers the Stop hook in ~/.claude/settings.json.
Usage
Skill Mode (via Claude Code)
When installed as a plugin, use the /notification-toolkit skill directly inside Claude Code:
Just ask Claude naturally — "change my notification to mario-1up", "turn off notifications at night", "make it quieter".
CLI Mode
Meme Sound Presets
Generate 11 chiptune meme sounds (requires python3):
| Sound | What it is |
|-------|-----------|
| metal-gear-alert | MGS "!" alert |
| mario-1up | Super Mario extra life |
| zelda-secret | Zelda secret discovery |
| sonic-ring | Sonic ring collect |
| victory-fanfare | Final Fantasy win jingle |
| codec-call | MGS codec ringtone |
| level-up | RPG ascending arpeggio |
| boxing-bell | Ding ding ding |
| nintendo-switch | Joycon snap click |
| fail-horn | Price Is Right losing horn |
| game-over | Arcade game over |
Custom Sounds
Drop .wav or .mp3 files into ~/.claude/notifications/sounds/custom/:
Sound names must use only letters, numbers, hyphens, and underscores.
Configuration
Config lives at ~/.claude/notifications/config.json:
| Field | Type | Description |
|-------|------|-------------|
| global.enabled | bool | Master on/off switch |
| global.volume | 0-100 | Audio volume percentage |