The launchd watchdog (claude-code.iterm-watchdog) runs every 30 seconds. When it finds a tab whose state file has been orange (waiting) for longer than THRESHOLD_MIN minutes, it fires a macOS notification via osascript. This skill is the user-friendly way to toggle the feature, change the threshold, change the sound, or test that it works.
Iterm Notifications is a community-contributed Claude Code skill in the general-misc sub-category. It ships as a SKILL.md file that Claude Code auto-discovers under ~/.claude/skills/iterm-notifications/ and loads when your prompt matches the skill's trigger.
When to invoke it: Use when the user types /iterm-notifications, asks to enable/disable the "Claude is waiting" notification, wants to change how long it waits before notifying, or wants to test that notifications are working. Accepts on/off, a numeric threshold (minutes), "test" to fire a one-off notification, and "sound <name|none>" to change the alert sound.
The Iterm Notifications Claude Code skill is built for Claude Code users and developers across all disciplines looking for general-purpose AI assistance. It's part of ClaudSkills (also referred to as Claude Skills or Claude Code Skills) — the open community-curated registry of 70,000+ SKILL.md files for Anthropic's Claude Code agent and the wider Claude ecosystem (Claude API, Claude Agent SDK).
mkdir -p ~/.claude/skills/iterm-notifications curl -L https://claudskills.com/skills/iterm-notifications/SKILL.md \ -o ~/.claude/skills/iterm-notifications/SKILL.md
Or just download SKILL.md directly and drop it into ~/.claude/skills/iterm-notifications/. Claude Code auto-discovers it on next session.
Skills live at ~/.claude/skills/iterm-notifications/SKILL.md on macOS/Linux, or %USERPROFILE%\.claude\skills\iterm-notifications\SKILL.md on Windows. See the full install guide for step-by-step instructions.
The ClaudSkills desktop app installs any skill directly into ~/.claude/skills/ with one click — no terminal required. Pro starts at $9/mo or $149 lifetime.
For the full experience including quality scoring and one-click install features for each skill — upgrade to Pro.
If you reference this skill in a blog post, paper, or documentation, you can cite it as:
@misc{iterm-notifications-2026,
author = {wasulajr},
title = {Iterm Notifications [Claude Code skill]},
year = {2026},
publisher = {ClaudSkills},
url = {https://claudskills.com/skills/iterm-notifications/}
}Browse all General skills in the ClaudSkills registry, or explore these other picks from the same category:
Part of Acreator Store — Adam Lankamer's AI tools: PerfectStudio · Ucaption · UTagger · AutoXPoster · TestYourSkills · AutomationFlows · Au Naturel
SKILL.md files, not affiliated with, endorsed by, or sponsored by Anthropic.