Know when Claude Code is running.

One Claude Code hook, four outputs: your RGB mouse changes color, a toast pops, your phone and watch buzz, and a local dashboard keeps score. No cloud. No account.

Get it on GitHub Quick start ↓

Windows · Python · MIT license

Running

Claude is working — go get coffee

Claude Code

Running a tool…

Four outputs

Pick your signal. Or run all four.

Every output can be toggled independently — from the dashboard settings page or an environment variable. Each one fails silently, so a dead mouse or closed browser never blocks Claude.

Ambient

RGB mouse

Your Logitech G102 shifts color with every state — via raw USB HID, no G HUB needed. Peripheral vision does the rest.

Local

Live dashboard

FastAPI + SSE on localhost. Session state, context %, usage limits — and a Jean-Claude Van Damme status indicator.

Away from desk

Phone + watch

Push via open-source ntfy.sh, mirrored to your smartwatch. Fires only when Claude actually needs you.

Native

Windows toast

A clean native popup on waiting and done — with context and quota stats appended to every finish.

The dashboard

Jean-Claude Van Damme tells you how it's going.

Every state has a face. The dashboard ships with JCVD reacting to your session — doing the splits while Claude runs, staring impatiently when it needs you, thumbs up when it's done. Don't like it? Paste any GIF URL per state in settings and make it yours.

ClaudeNotify

JCVD · doing the splits

Running

Tool: PowerShell

jean-claude van damme status indicator

Running https:// …

Waiting for you https:// …

Done — your turn https:// …

Ready https:// …

Blank reverts to the default JCVD gif. Saved to config, takes effect on the next hook event — no restart.

Demo: Logitech G102 mouse changing from red to green as Claude Code finishes a task — the mouse, changing its mind

Demo: the live dashboard switching from Running to Waiting-for-you, with the JCVD status indicator — the dashboard, live

How it works

One hook fans out to everything.

Claude Code lifecycle events pipe into a single entrypoint that fires all outputs in parallel threads. Claude Code never blocks on the hook — it fires async. Total added latency to your session: none.

Claude Code lifecycle event
        │
        ▼
  hooks in settings.json
        │
        ▼
  notify.py <EventName>
        │
        ├── ntfy.sh ──────────► 📱 phone ► ⌚ watch
        ├── USB HID ──────────► 🖱️ G102 RGB
        ├── localhost:8765 ───► 🌐 dashboard (SSE)
        └── Windows API ──────► 🔔 toast popup

Quick start

Running in about 10 minutes.

Clone the repo

git clone https://github.com/bojnesh/ClaudeNotify

Run setup with your own channel name

Installs Python deps, copies scripts to ~/.claude/, merges hook config.

.\setup.ps1 -Channel "claude-yourname-xk7q2"

Subscribe on your phone, restart Claude Code

Install the free ntfy app, subscribe to your channel, restart Claude Code — hooks load on session start. Done.