macOS native

cc-beacon

Floating HUD notifications for Claude Code. No dock icon. No Notification Center. Just a quiet overlay.

View on GitHub

⏸

Permission Required

Claude wants to run: npm install

📁 my-saas-app

💬

Waiting for Input

Which database should I use for this project?

📁 my-saas-app

✓

Task Complete

All 47 tests passing. Created PR #142 for review.

📁 my-saas-app

How it works

Hook JSON on stdin
  Notification  notification_type → HUD color & icon
                message           → body text
                cwd               → project name

  Stop          transcript_path   → last assistant message
                cwd               → project name

  Output:  HUD overlay

Install

curl -sL https://raw.githubusercontent.com/4bdullatif/cc-beacon/main/install.sh | bash