Skillget

claude_bell

skill
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 7 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This is a native macOS menu bar application that provides a graphical interface for managing Claude Code sessions. It bridges terminal-based events—like permission requests, questions, and task completions—into a unified desktop notification panel.

Security Assessment
Overall risk: Low. The tool runs a local HTTP server on `localhost:19485` to receive events from Claude Code via local hooks. It does not make external network requests or phone home. The automated code scan checked 7 files and found no dangerous patterns, hardcoded secrets, or hidden shell command executions. The application handles permission prompts (approve/deny) locally, meaning your responses stay entirely on your machine. While it does request access to terminal applications and requires a global hotkey, these are standard, expected behaviors for a menu bar utility of this nature.

Quality Assessment
The project is very new and currently has low community visibility with only 5 GitHub stars. However, the codebase is transparent, well-documented, and recently active (last push was today). It is properly licensed under the permissive MIT license. The codebase is small (only 7 files scanned), making it easy for any developer to manually review before use. The creator distributes a pre-compiled app via a dedicated website, but thoughtfully provides instructions for users to build it from source to ensure safety.

Verdict
Safe to use, though users should build the application from source rather than downloading the pre-compiled binary to fully verify its behavior.
SUMMARY

Native macOS menu bar app for Claude Code — unifies notifications, permission prompts, and hook events from all sessions in one place. Free & open source.

README.md

Claude Bell

A macOS menu bar app that bridges Claude Code notifications to a native UI. When Claude Code needs your attention (permission requests, questions, task completions), Claude Bell shows them in a panel accessible from the menu bar bell icon.

Claude Bell demo

Features

  • Permission requests — approve or deny tool usage directly from the panel
  • Interactive notifications — respond to questions and elicitation dialogs without switching to the terminal
  • Session tracking — see all active Claude Code sessions at a glance
  • Conversation context — view transcript history for each notification
  • Shortcut to open — a global hotkey (default ⌘⇧B, fully remappable) surfaces the latest notification from any app
  • Enter to confirm — arrow keys move focus between actions, Return fires the focused one — keyboard-only flow, mouse optional
  • Open in Terminal — one click jumps back to the originating Terminal.app or iTerm2 tab that triggered the request
  • Sound alerts — configurable notification sound when Claude needs attention
  • One-click setup — installs Claude Code hooks automatically from the app settings

How it works

Claude Bell runs a local HTTP server on localhost:19485 that receives events from Claude Code via hooks. The configured hooks are:

Hook Purpose
PermissionRequest Tool permission prompts (approve/deny)
Notification Questions, idle prompts, elicitation dialogs
PreToolUse Clears stale notifications when session advances
PostToolUseFailure Tool error notifications
Stop Task completion
SessionEnd Removes closed sessions from the panel

Requirements

  • macOS 14 (Sonoma) or later
  • Swift 5.10+
  • Claude Code with hooks support

Install (no build required)

Download the pre-compiled app from claude-bell.com, unzip, and drag ClaudeBell.app into /Applications. On first launch, open Settings in the app and click "Enable Hooks" to configure Claude Code.

Build from source

See BUILDING.md for debug and release build instructions.

License

Released under the MIT License. The app is free and always will be — no license keys, no trials, no accounts.

Support the project ☕

ClaudeBell is built and maintained in my spare time. If it saves you time or makes your Claude Code workflow better, consider supporting the project:

☕ Buy me a coffee

Every coffee helps cover the macOS developer account, code signing, and the time spent on fixes and new features. It's entirely optional — the app stays fully functional and free either way.

Project structure

Sources/
  App/            — App entry point, global shortcut, AppDelegate
  Models/         — Data models (HookInput, NotificationEntry, PendingRequest, SessionInfo)
  Server/         — HTTP server receiving Claude Code hooks (Hummingbird)
  Resources/      — Bundle resources (changelog.json)
  Setup/          — Hook, auto-mode, and statusline installers
  Store/          — RequestStore (central state management)
  Terminal/       — Terminal tab detection and focus (TerminalBridge)
  Transcript/     — Claude Code transcript parser
  Update/         — Auto-update checker and installer
  Utilities/      — Markdown renderer, formatters, helpers
  Views/          — SwiftUI views (panel, detail views, setup)
public/           — Vercel-served landing page + ClaudeBell.zip download

Reviews (0)

No results found