dsh-sound-plugin
中文 | English
Want to do something else while DeepSeek Harness works for you? Just install this plugin — it calls you back with a system sound the moment it needs you.
A DeepSeek Harness plugin that plays a system sound when:
- the AI finishes responding (completion sound), and/or
- a pending approval or user question appears (approval reminder).
Each is an independent toggle in Settings → General.
Install
# GitHub shorthand
dsh plugin --profile <name> add github:dev-rookiestar/dsh-sound-plugin
# or full git URL
dsh plugin --profile <name> add git+https://github.com/dev-rookiestar/dsh-sound-plugin.git
Replace <name> with your profile name:
- Desktop app:
desktop (quit the app first — its profile is managed exclusively by the Electron application).
- Web app:
web.
- Or any custom name, e.g.
my-profile.
Then restart DSH (or reload the profile) and open Settings → General to see the two toggles.
What is a profile?
A profile is a named, independent environment with its own plugins and settings — like a browser profile (each has its own extensions). Profiles live under ~/.dsh/profiles/<name>.
Installing with --profile <name> adds the plugin to that environment only, so different profiles can hold different plugin sets without interfering.
Requirements
- DeepSeek Harness
>=0.2.0 <0.3.0 (developed and tested on 0.2.1-rc.3).
- Sound playback uses a system command:
- Windows: PowerShell (
System.Media.SoundPlayer) — built in.
- macOS:
afplay — built in.
- Linux:
paplay (PulseAudio / PipeWire). Install pulseaudio-utils if paplay is missing.
How it works
- Completion sound: listens to
agent/status and plays once after every agent (the main turn plus any subagents) has gone idle.
- Approval reminder: listens to the session event feed for
approval/asked and ask_user_question tool calls.
- The "ding-dong" WAV is generated in memory (no bundled audio file) and played through the default audio device.
License
MIT
