Hook

Notify when Claude finishes

Fires a desktop notification when Claude stops — so you can switch tasks during a long run and get pulled back when it's done.

notificationstopproductivity

Install to

settings.json → hooks.Stop

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "if command -v osascript >/dev/null; then osascript -e 'display notification \"Claude finished\" with title \"Claude Code\" sound name \"Glass\"'; elif command -v notify-send >/dev/null; then notify-send \"Claude Code\" \"Claude finished\"; fi"
          }
        ]
      }
    ]
  }
}

json · 14 lines

1{
2  "hooks": {
3    "Stop": [
4      {
5        "hooks": [
6          {
7            "type": "command",
8            "command": "if command -v osascript >/dev/null; then osascript -e 'display notification \"Claude finished\" with title \"Claude Code\" sound name \"Glass\"'; elif command -v notify-send >/dev/null; then notify-send \"Claude Code\" \"Claude finished\"; fi"
9          }
10        ]
11      }
12    ]
13  }
14}

How to install

Open your settings file: ~/.claude/settings.json (user), .claude/settings.json (project, shared), or .claude/settings.local.json (project, private).
Merge the hooks block into it. If a hooks key already exists, add this event to it rather than replacing the whole object.
Hooks live-reload — no restart needed in most cases.
Verify: run /debug to confirm the hook is registered, then trigger the event (e.g. edit a file) and watch it fire.
This hook relies on jq reading the event JSON from stdin — make sure jq is installed.

← More hooks