Iterm Notify

macOS desktop notifications and iTerm2 badge management for Claude Code lifecycle events. Not a slash command — this plugin provides hook scripts. See README for wiring instructions.

majiayu000 Updated 567 repo stars

File contents

iterm-notify

Provides notify.sh — a hook script that fires on Claude Code Notification and Stop events.

Not a slash command. Wire it in ~/.claude/settings.json — see README.

What it does

On Notification (Claude needs attention):

  • Bounces the iTerm2 dock icon once
  • Sets an iTerm2 badge: <topic> ⚡ (or just ⚡ if no topic file)
  • Sends a macOS desktop notification via terminal-notifier with a click-to-focus action

On Stop (Claude finished):

  • Clears the iTerm2 badge

Prerequisites

  • macOS with iTerm2
  • terminal-notifier: brew install terminal-notifier
  • jq: brew install jq

Wiring

See README for setup instructions.

majiayu000/claude-skill-registry-data/tree/main/system/iterm-notify commit 6f06f98355

Frequently asked questions

npx skillmds@latest add majiayu000/iterm-notify