Skip to content

Releases: pramirez140/claude-code-mac-notifications

Release list

v0.2.0 — Notification hook + pro GitHub scaffolding

v0.2.0 — Notification hook + pro GitHub scaffolding Latest
Latest

Choose a tag to compare

View all tags
@pramirez140 pramirez140 released this 05 May 15:15
v0.2.0
7280ca1

Adds the missing half of "tell me what Claude is doing" — a banner when Claude is waiting on you, not just when it's done. Plus full professional repo scaffolding (CI, issue templates, contributing guide, security policy).

✨ New: Notification hook

Fires when Claude is waiting on user input — permission prompts, AskUserQuestion, idle timeouts.

  • Body: "Needs your input"
  • Plays the system sound (more attention-grabbing than the Stop banner — it's a call to action)
  • Instant — ~40ms. No LLM call.
  • Same claude-stop group as the Stop banner, so a fresh "needs input" displaces a stale "done" cleanly.
  • Same click-to-focus mechanism — jumps you to the exact terminal window/tab Claude is in.

🛠️ Repo upgrades

  • CI: ShellCheck + JSON/YAML validation + bash syntax check + a real macos-latest end-to-end installer dry-run with an idempotence check
  • Issue templates: form-based bug report and feature request, with a Discussions deflector for questions
  • Pull request template: explicit test-plan checkbox set
  • CHANGELOG.md: Keep a Changelog format
  • CONTRIBUTING.md: dev setup, manual testing recipes, "adding a new terminal" guide
  • SECURITY.md: private vulnerability reporting + a clear threat model
  • CODE_OF_CONDUCT.md: Contributor Covenant 2.1
  • README rewrite: badges, table of contents, dual data-flow diagram, roadmap, acknowledgements
  • .editorconfig + expanded .gitignore

⬆️ Upgrade

If you installed via install.sh:

cd claude-code-mac-notifications
git pull
./install.sh           # idempotent — re-running just refreshes

If you installed as a plugin:

/plugin update claude-code-mac-notifications@claude-code-mac-notifications

Then open /hooks once (or restart Claude Code) so the watcher picks up the new Notification entry.

Full changelog: CHANGELOG.md

Assets 2
Loading

v0.1.0 — Initial release

v0.1.0 — Initial release

Choose a tag to compare

View all tags
@pramirez140 pramirez140 released this 05 May 15:15
v0.1.0
6a64b90

First public release of claude-code-mac-notifications — native macOS notifications for Claude Code Stop events.

What you get

  • 🛎️ Stop banner — fires after every Claude turn with a 3-to-4 word AI summary of what was done ("Refactored Auth Module", "Researched Game Server Hosting").
  • 🎯 Click-to-focus the right window — captures the Claude session's TTY, then matches it via AppleScript on click. Per-tab targeting on Apple Terminal and iTerm2.
  • 🟠 Claude-branded thumbnail — orange burst icon on the right of the banner, bundled in the repo (no Claude.app dependency).
  • 🪝 Two install paths — plain install.sh (idempotent) or Claude Code plugin marketplace.
  • ♻️ Clean uninstall — surgical removal of just our hook entries.

Install

git clone https://github.com/pramirez140/claude-code-mac-notifications
cd claude-code-mac-notifications
./install.sh

…or as a Claude Code plugin:

/plugin marketplace add pramirez140/claude-code-mac-notifications
/plugin install claude-code-mac-notifications@claude-code-mac-notifications

See the README for full details.

Full changelog: CHANGELOG.md

Loading