Give Claude Code a voice.

Gentle sound cues for every move your agent makes — start, done, error, needs you. So you can walk away. Free, open source, one command.

> /plugin marketplace add mannanj/claude-cues > /plugin install claude-cues@claude-cues

macOS · Linux · ~200KB · no dependencies · view source

▶ click a sound below to listen

Hear it

Every session gets one consistent voice, rotating session to session. Pick a personality above, then trigger the real events below.

claude — try it: type and press enter

✶ session started — personality: chime

How it works

hooks

Claude Code hooks fire on six session events and call one tiny script. Fire-and-forget — it never blocks or errors your session.

rotates

One personality per session, next one next session. Distinct voices, never mixed mid-session, never stale.

yours

A personality is just a folder of mp3s. Drop in your own and it joins the rotation. All bundled audio is original and CC0.

Install

# inside Claude Code
/plugin marketplace add mannanj/claude-cues
/plugin install claude-cues@claude-cues

No /plugin? git clone https://github.com/mannanj/claude-cues && cd claude-cues && ./install.sh — a short, readable script that merges the hooks into your settings (and ./uninstall.sh removes them).

FAQ

Does it slow Claude Code down?

No. Each hook backgrounds the sound player and returns immediately. There's no daemon, no network, no telemetry — just a shell script and 24 small mp3s.

Can I use my own sounds?

Yes. A personality is a folder: sounds/<name>/<event>/*.mp3. Add one and it joins the session rotation automatically.

How do I turn it off?

/claude-cues:toggle inside Claude Code, or set ENABLED=0 in ~/.claude/claude-cues/config. Uninstall is one command.

Windows?

Not yet — the script no-ops silently on unsupported platforms, so nothing breaks. PRs welcome.

Is the audio really free?

Yes — every sound was synthesized for this project and is dedicated to the public domain (CC0). The code is MIT.