Claude Sound Fx

English | 中文 | 日本語
You kick off a task, switch to your browser, and forget about the terminal.
Five minutes later you check back — it's been waiting for you the whole time.

Sound FX adds themed audio cues to Claude Code and Opencode so you never have to babysit the terminal again. Hear when a task finishes, when something breaks, or when the AI needs your input — even while you're in another window.

Pick a single theme or go Mix mode and let 12 themes collide randomly. JARVIS confirms your deploy. GLaDOS mocks your errors. Pikachu celebrates your tests passing. A WoW Peon reluctantly obeys your commands.

https://github.com/user-attachments/assets/c47537fc-1c18-4256-877d-0f22d4314bfd

Platform Support

Works on every major platform. No extra setup needed for local use.

Remote server setup

When running on a headless server with no audio hardware, sounds are forwarded to your local machine via a lightweight HTTP relay:

Relay commands:

Install

Claude Code

Then configure your theme:

The setup wizard will walk you through theme selection and trigger mode.

Opencode

Add to opencode.json:

Shares the same config file (~/.claude/sound-fx.local.json) and audio themes.

Update or Remove

Run the same command anytime:

The wizard will ask you to Configure, Update, or Remove:

Themes

Sci-Fi & AI

Anime

Gaming & Other

How It Works

Sound FX hooks into 7 lifecycle events:
Note: Tool permission prompts (the approve/deny popup) are not a hookable lifecycle event in Claude Code, so this plugin cannot play sounds for them.

Modes

Trigger Levels

Config is stored at ~/.claude/sound-fx.local.json. Re-run /sound-fx:setup anytime to change.

Add Your Own Theme

No code changes needed. Just add a directory under assets/:

manifest.json format:

Empty arrays [] are fine — that…