If you use claude code, you're gonna want blooop. Stop staring at a static cursor. Get a ping when Claude needs you.
blooop is a decently-high-performance terminal wrapper designed for the AI-first developer workflow. Claude code. It monitors Claude Code and alerts you via a sound the second it goes idle or encounters an interactive prompt. That way you can keep the vibes flowing.
Context switching is the silent killer of productivity. If you want to get the most outta those 5x subscription you're going to want blooop. blooop bridges the gap between "the AI is thinking" and "I'm back to work," allowing you to stay in flow without the anxiety of missing a prompt.
npm install -g blooopTest your notifications and sound instantly:
blooop --demoThen, wrap Claude Code:
blooop claudefor you less technical folks, you literally just type "blooop claude" in the terminal.
Pro Tip: Alias your common commands so they always blooop:
# Add to ~/.zshrc or ~/.bashrc
alias claude="blooop claude"if this doesn't make sense, ask claude to check out this readme. it will explain 10x better than i can.
blooop implements a low-latency PTY (Pseudo-Terminal) pass-through. Unlike simple piping, this ensures:
- Full ANSI Support: Colors, bold text, and terminal "spinners" work perfectly.
- Interactive Shells: Claude Code behaves exactly as if it were running natively.
- Heuristic Detection: Intelligent pattern matching for interactive prompts (
y/n,confirm?) and configurable idle-state triggers.
A notification fires when:
- Claude's input prompt appears — detected via positive pattern matching.
- A confirmation is needed — patterns like
(y/n),Do you want to..., orPress Enter. - Silence after submission — triggers after a period of inactivity (default 4s) once you've sent a command.
| Key | Action |
|---|---|
Ctrl+B |
Inline Sound Picker — Change your notification sound without leaving the session. |
| Variable | Default | Description |
|---|---|---|
BLOOOP_IDLE_MS |
4000 |
Milliseconds of silence before triggering. |
BLOOOP_DISABLE_IDLE |
— | Set to 1 to disable idle detection (prompts still trigger). |
BLOOOP_DEBUG |
— | Set to 1 to print internal state logs. |
BLOOOP_NO_UPDATE_CHECK |
— | Set to 1 to disable the background update check. |
blooop stores settings in ~/.blooop.json. It re-reads this file on every notification, so changes take effect immediately.
{
"sound": "/path/to/your/custom-sound.mp3"
}(untested)
| Platform | Audio Engine |
|---|---|
| macOS | afplay |
| Linux | paplay or aplay |
| Windows | PowerShell Media.SoundPlayer |
ISC
