Claude Buzz — Development skill for Claude Code

claude-buzz

Native macOS notifications when Claude Code needs you. Click to jump to the right terminal.

Running 12 Claude Code sessions across multiple terminals? Stop tab-surfing. `claude-buzz` pings you the second any session needs input — and clicking the notification takes you straight there.

Install

npm install -g claude-buzz
claude-buzz install

That's it. Every Claude Code session on your machine will now notify you when it's waiting for input or needs permission. No background processes, no polling — it hooks directly into Claude Code.

What you'll see

When Claude finishes a response or needs permission:

• "Ready for input" — Claude is done and waiting for your next prompt
• "Needs permission" — Claude wants to run a tool and needs your OK (shows the exact command)

Notifications include the project folder name so you know exactly which session needs you.

What it does

• Hooks into Claude Code natively — uses the built-in hooks system, zero background processes
• Smart notifications — debounces rapid-fire events, skips if you're already looking at the terminal
• Click to focus — click the notification to jump to the exact terminal tab
• Works globally — one install covers all current and future sessions
• Permission-aware — shows what Claude needs permission for

Commands

claude-buzz install     # Add hooks to Claude Code
claude-buzz uninstall   # Remove hooks cleanly
claude-buzz status      # Check if active
claude-buzz test        # Send a test notification

How it works

Claude Code has a [hooks system](https://docs.anthropic.com/en/docs/claude-code/hooks) that fires shell commands on lifecycle events. `claude-buzz` registers two hooks in your global `~/.claude/settings.json`:

• Stop — fires when Claude finishes responding and is ready for your next prompt
• Notification — fires when Claude needs permission to