Getting Started
Requirements
- Claude Code CLI
- jq (for JSON parsing)
- Bash (macOS, Linux) or PowerShell (Windows)
Installing jq
# macOS
brew install jq
# Ubuntu/Debian
sudo apt install jq
# Fedora
sudo dnf install jq
# Windows (Chocolatey)
choco install jq
Platform-specific Notification Tools
| Platform | Required Tool | Pre-installed |
|---|---|---|
| macOS | osascript | Yes |
| Linux | notify-send | Usually |
| Windows | PowerShell | Yes |
| WSL | PowerShell (Windows) | Yes |
If notify-send is missing on Linux:
# Ubuntu/Debian
sudo apt install libnotify-bin
# Fedora
sudo dnf install libnotify
# Arch
sudo pacman -S libnotify
Installation
git clone https://github.com/js-koo/claude-code-notifier.git && cd claude-code-notifier && ./install.sh
Restart Claude Code after installation.
Verify Installation
/notifier status
Shows current settings if installed correctly.
/notifier test
Success if you receive a notification.
Commands
| Command | Description | Default |
|---|---|---|
/notifier help | Help | |
/notifier status | Current settings | |
/notifier test | Test notification | |
/notifier duration <sec> | Minimum task duration | 20 |
/notifier lang <ko|en> | Notification language | en |
/notifier preview <len> | Prompt preview length | 45 |
/notifier uninstall | Uninstall |
Configuration Examples
# Notify only for tasks over 30 seconds
/notifier duration 30
# Korean notifications
/notifier lang ko
# Notify on all task completions
/notifier duration 0
Notification Messages
| Event | Korean | English |
|---|---|---|
| Task complete | 작업 완료! | Task completed! |
| Permission request | 권한 요청 대기 중 | Permission request waiting |
| Waiting for input | 입력을 기다리는 중 | Waiting for input |
Config File
Settings are stored at ~/.config/claude-code-notifier/config.
MIN_DURATION_SECONDS=20
NOTIFIER_LANG=en
PROMPT_PREVIEW_LENGTH=45
Uninstall
/notifier uninstall
Troubleshooting
No notifications
- Check
notify-sendinstallation (Linux):
which notify-send
-
Check notification permissions (macOS):
- System Settings → Notifications → Allow terminal app
-
Check Do Not Disturb mode
No notifications in WSL
WSL uses Windows notifications:
powershell.exe -Command "echo test"
Permission errors
chmod +x install.sh
chmod +x hooks-handlers/*.sh