devbell 0.1.0

Audio notifications and push alerts for Claude Code

devbell

Audio notifications and push alerts for Claude Code. Plays sounds when Claude finishes responding, needs your attention, or starts a new session.

Install

pipx install devbell

Setup

# Configure hooks in Claude Code
devbell install

# (Optional) Enable push notifications
devbell config --ntfy my-topic

# Test everything works
devbell test

What it does

Event	Sound	When
welcome	Greeting chime	New Claude Code session starts
response_ready	Notification tone	Claude finished responding (30s cooldown)
permission_needed	Alert tone	Claude needs your attention

Push notifications (optional)

devbell can send push notifications to your phone via ntfy.sh (free, no account needed):

1. Install the ntfy app on your phone (Android / iOS)
2. Subscribe to a topic (e.g., my-devbell)
3. Configure devbell:

devbell config --ntfy my-devbell

4. Test it:

devbell push "Hello from devbell!"

Commands

devbell install              # Add hooks to ~/.claude/settings.json
devbell uninstall            # Remove hooks
devbell play <event>         # Play a specific sound
devbell push "message"       # Send push notification
devbell test                 # Test all channels
devbell config --list        # Show configuration
devbell config --ntfy topic  # Set ntfy topic
devbell config --cooldown 30 # Set response_ready cooldown
devbell config --sound event=/path/to/custom.mp3  # Custom sound
devbell config --disable     # Disable all sounds
devbell config --enable      # Re-enable

Custom sounds

Replace any sound by placing your mp3 in the config directory:

• Windows: %APPDATA%/devbell/sounds/
• macOS/Linux: ~/.config/devbell/sounds/

File names: welcome.mp3, response_ready.mp3, permission_needed.mp3

Uninstall

devbell uninstall    # Remove hooks from Claude Code
pipx uninstall devbell