← Marketplace
Productivity

iterm-notifyv0.1.0

macOS desktop notifications and iTerm2 badge management for Claude Code lifecycle events

By harnessprotocolApache-2.0Source ↗
OfficialVerified

Install

Add the marketplace once, then install the plugin:

/plugin marketplace add harnessprotocol/harness-kit
/plugin install iterm-notify@harness-kit
notificationsmacositerm2hooks

Security & permissions

Verified1 info

Declared capabilities

Network accessYes
File writesNo
Environment variablesNone
External URLs1
Filesystem patternsNone

Scan observations

  • infoscripts/notify.sh:7

    External URL detected: https://iterm2.com

    Verify this URL is necessary and trustworthy. Consider if this data should be fetched at install time or runtime.

Scanned at build time from source. How trust signals work →

Skill1

iterm-notifyskills/iterm-notify/SKILL.md
iterm-notify

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.