iterm-notify
OfficialGet instant iTerm2 badges and macOS alerts.
Software Engineering#claude code#hooks#notifications#macos#iterm2#terminal-notifier#badge management
Authorharnessprotocol
Version1.0.0
Installs0
System Documentation
What problem does it solve?
It helps you notice when Claude Code needs your attention and when a task is finished, without constantly watching the iTerm2 session.
Core Features & Use Cases
- iTerm2 badge on Notification: Bounces the dock icon, sets an iTerm2 badge to indicate activity, and reads a configurable label from a local file to show context like the current project.
- macOS desktop notification on Notification: Sends a clickable notification using terminal-notifier that focuses the iTerm2 window running Claude.
- Badge cleared on Stop: Resets the iTerm2 badge when Claude completes work.
Quick Start
Wire the plugin hook into your ~/.claude/settings.json so the Notification and Stop events both call the provided notify.sh script.
Dependency Matrix
Required Modules
terminal-notifierjq
Components
scripts
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: iterm-notify Download link: https://github.com/harnessprotocol/harness-kit/archive/main.zip#iterm-notify Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.