claudible 0.1.1

Ambient audio soundscape feedback for terminal output - an opus for your terminals

claudible

An opus for your terminals.

Possibly the most annoying Claude utility ever made but here it is anyway. Ambient audio soundscape feedback for terminal output.

The Idea

Imagine you are working in a factory. Each Claude Code session is a machine that must be attended to. When it's working, you hear it - crystalline sparkles as text flows, soft chimes when tasks complete. When it goes quiet, you know something needs your attention.

Installation

pip install claudible

Usage

# Run claude with audio feedback (default)
claudible

# Run a different command
claudible "python my_script.py"

# Pipe mode
some-command 2>&1 | claudible --pipe

# Choose a sound character
claudible --character crystal

# Adjust volume
claudible --volume 0.3

# List available characters
claudible --list-characters

Reverse Mode

In reverse mode, claudible is silent while output is flowing and plays ambient sound during silence. Useful when you want to know a task is waiting rather than working.

# Ambient grains play when Claude is idle/waiting for you
claudible --reverse

# Combine with a character
claudible --reverse -c shell

Works With Any CLI

Built for Claude Code, but claudible works with anything that produces terminal output.

# Aider
claudible "aider"

# Watch a dev server
npm run dev 2>&1 | claudible --pipe

# Monitor logs
tail -f /var/log/app.log | claudible --pipe -c droplet

Sound Characters

Character	Description
ice	Brittle, very high, fast decay with pitch drop
glass	Classic wine glass ping
crystal	Pure lead crystal with beating from close partial pairs
ceramic	Duller muted earthenware tap
bell	Small metallic bell, classic ratios, long ring
droplet	Water droplet, pitch bend down, liquid
click	Sharp mechanical click, keyboard-like
wood	Hollow wooden tap, warm marimba-like resonance
stone	Dense slate tap, heavy and earthy
bamboo	Hollow tube resonance, odd harmonics, breathy and airy
ember	Warm crackling ember, fire-like with wide pitch scatter
silk	Soft breathy whisper, delicate airy texture
shell	Swirly ocean interference, dense phase beating
moss	Ultra-soft muffled earth, mossy dampness

Options

Flag	Description
--pipe	Read from stdin instead of wrapping
--character, -c	Sound character
--volume, -v	Volume 0.0-1.0 (default: 0.5)
--attention, -a	Silence alert seconds (default: 30)
--reverse, -r	Reverse mode: sound during silence, quiet during output
--list-characters	Show presets

Development

Test locally without installing:

cd claudible

# Run wrapping claude (Ctrl+C to stop)
PYTHONPATH=src python3 -m claudible

# Wrap a different command
PYTHONPATH=src python3 -m claudible "ls -la"

# Pipe mode
echo "test" | PYTHONPATH=src python3 -m claudible --pipe -c glass

# List characters
PYTHONPATH=src python3 -m claudible --list-characters

License

MIT