Claude Done Notifier

Shows a VS Code notification when Claude Code finishes responding, or when it is waiting on you for input or a permission decision.

How it works

VS Code extensions cannot observe Claude Code's internal state, so this uses a ping:

1. The extension runs a tiny HTTP listener bound to 127.0.0.1 (loopback only).
2. Claude Code http hooks POST to it on the Stop and Notification events.
3. The extension turns each ping into a native VS Code notification.

Setup

Add these hooks to ~/.claude/settings.json:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          { "type": "http", "url": "http://127.0.0.1:37123/notify", "timeout": 5 }
        ]
      }
    ],
    "Notification": [
      {
        "hooks": [
          { "type": "http", "url": "http://127.0.0.1:37123/notify", "timeout": 5 }
        ]
      }
    ]
  }
}

Claude Code posts the full hook payload, and the extension reads hook_event_name to tell "done" apart from "waiting for you".

Settings

Commands

• Claude Notifier: Send Test Notification
• Claude Notifier: Toggle Notifications (also bound to clicking the status bar item)
• Claude Notifier: Show Listener Status

Notes

• The listener binds to loopback only, so nothing off your machine can reach it.
• If you run several VS Code windows, the first one wins the port; the others report EADDRINUSE and show an offline status bar item. Notifications still appear in the window that holds the port.
• Changing the port requires a window reload.

License

MIT