claude-notify

claude-notify

Get notified when Claude Code finishes working. Supports desktop (macOS, Linux, Windows), mobile via ntfy, and custom webhooks.

Also gives each git worktree its own stable loopback IP — so parallel Claude sessions don't fight over dev server ports.

Install

Requires Node.js 18 or later.

That's it. Claude Code will notify you from now on.

How it works

Adds a Stop hook to ~/.claude/settings.json. When a Claude Code session ends, it runs claude-notify send, reads the session transcript, and sends a summary to your configured channels.

Example notification body: 3 files edited · 2 commands

Channels

Desktop (default, zero config)

Works out of the box on macOS, Linux, and Windows. Uses native OS notifications.

Mobile — ntfy.sh (free, no account needed)

1. Install the ntfy app on your phone
2. Pick a topic — make it unguessable, it's your auth

3. Subscribe to ntfy.sh/your-secret-topic-xyz in the app

Self-hosted ntfy also works:

Webhooks (Slack, Discord, custom)

Default body template: {"text": "{{title}}: {{body}}"} — change with channels.webhook.bodyTemplate.

Worktree IP isolation

When running multiple Claude Code sessions in parallel, each session spins up its own dev server — and they all try to use the same ports.

claude-notify ip prints a stable loopback IP derived from the current git worktree path. Same worktree always gets the same IP. Different worktrees get different IPs. Bind your servers to it and they'll never conflict.

Or export it once at the start of the session:

Linux: no setup needed — the kernel routes the entire 127.0.0.0/8 block to loopback automatically.

macOS: run once per system boot to register the alias:

Commands

Config reference

Config lives at ~/.config/claude-notify/config.json (mode 600).

License

MIT