Skip to content

Releases: steryereo/claude-hooks

v1.0.0 — first public release

Choose a tag to compare

@steryereo steryereo released this 27 Jun 07:26

macOS desktop notifications for Claude Code, installable as a plugin.

Features

  • Notifications — a desktop banner when Claude finishes a turn (Stop) or needs attention (Notification, e.g. permission prompts / idle waits).
  • Click-to-focus — clicking a banner brings the originating window/tab forward. On iTerm2 it targets the exact session via $ITERM_SESSION_ID; otherwise it matches on window title.
  • Already-focused suppression — no banner when you're already looking at that session. Precise on iTerm2 (pane/session level); title-match on other hosts.
  • Host apps — VS Code, iTerm2, and Terminal.app out of the box; others still notify (focus/suppression skipped).

Install

/plugin marketplace add steryereo/claude-hooks
/plugin install claude-hooks@steryereo

Requirements

macOS, plus terminal-notifier and jq (brew install terminal-notifier jq).