Metadata-Version: 2.4
Name: devbell
Version: 0.1.0
Summary: Audio notifications and push alerts for Claude Code
Author: Jose
License-Expression: MIT
Keywords: audio,claude,developer-tools,hooks,notifications
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.9.0
Provides-Extra: all
Requires-Dist: httpx>=0.24.0; extra == 'all'
Provides-Extra: ntfy
Requires-Dist: httpx>=0.24.0; extra == 'ntfy'
Description-Content-Type: text/markdown

# devbell

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

## Install

```bash
pipx install devbell
```

## Setup

```bash
# 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](https://ntfy.sh) (free, no account needed):

1. Install the ntfy app on your phone ([Android](https://play.google.com/store/apps/details?id=io.heckel.ntfy) / [iOS](https://apps.apple.com/app/ntfy/id1625396347))
2. Subscribe to a topic (e.g., `my-devbell`)
3. Configure devbell:

```bash
devbell config --ntfy my-devbell
```

4. Test it:

```bash
devbell push "Hello from devbell!"
```

## Commands

```bash
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

```bash
devbell uninstall    # Remove hooks from Claude Code
pipx uninstall devbell
```
