notify-on-complete

name	notify-on-complete
description	Send system notifications when Claude Code completes tasks. Use when the user wants to configure task completion notifications, set up alerts for long-running tasks, or customize notification settings.

Task Completion Notification

Send system notifications when Claude Code tasks complete, perfect for long-running tasks or team collaboration.

Automatic Setup

When this plugin is installed through Claude Code, notifications are enabled automatically by hooks/hooks.json.

For manual source-checkout installs only, run:

bash ~/.claude/plugins/meta-plugin/scripts/setup-notification.sh

Hook Configuration

The plugin ships this Stop hook:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/scripts/notify.sh",
            "args": ["Claude Code", "任务已完成，请查看结果"],
            "timeout": 10
          }
        ]
      }
    ]
  }
}

Customization

# Custom title and message
bash ~/.claude/plugins/meta-plugin/scripts/notify.sh "My Project" "代码审查完成"

# Disable sound
NOTIFY_SOUND=false bash ~/.claude/plugins/meta-plugin/scripts/notify.sh

# Disable terminal output
NOTIFY_TERMINAL=false bash ~/.claude/plugins/meta-plugin/scripts/notify.sh

Platform Support

Platform	Method	Requirements
macOS	osascript	Built-in
Linux	notify-send	libnotify-bin package
Windows	PowerShell	WSL or Git Bash

Test Notification

bash ~/.claude/plugins/meta-plugin/scripts/notify.sh "Test" "Test notification"

Troubleshooting

Linux: notify-send not found

# Ubuntu/Debian
sudo apt-get install libnotify-bin

# Fedora
sudo dnf install libnotify

No sound on Linux

sudo apt-get install pulseaudio-utils

Support

For issues, report at the repository's issue tracker.