DeepSeek Harness (DSH) uses a plugin-based architecture. In agent development, clear feedback helps developers quickly identify task status. dsh-chime replicates opencode’s task completion chime, providing three embedded audio effects—completion, question, and error—with zero external dependencies.

Core Features

  • Embedded audio: raw MP3 files packaged as base64, with no need to download external files.
  • Event listening: listens to agent/status and tools/execute events.
  • Endpoints: provides /chime/poll and /chime/debug endpoints.
  • Three sounds: supports completion, question, and error notification sounds.

Installation and Enablement

Run the following command in your terminal to install it:

dsh plugin --profile web add dsh-chime

After installation, restart the web process. The plugin is automatically loaded with the profile. No additional configuration is required.

Typical Usage

No action is required after installation; the notification sounds take effect automatically. To debug or preview them, use the following commands:

Check the current queue status and recent history:

curl http://127.0.0.1:3080/chime/debug

Preview a specific sound:

curl http://127.0.0.1:3080/chime/debug?play=done

Available play parameter values are done, question, and error.

Working Details

  • Trigger timing: the completion sound is triggered when a reply cycle ends; the error sound is triggered when it ends with an error; the question sound is triggered when the question tool (ask_user_question) or plan submission tool (exit_plan_mode) starts executing.
  • Scope: Host-level listening; all sessions (including subagents) trigger a sound on completion.
  • Persistence: remains effective after restarts and is automatically loaded with the profile.

Notes

  • The question sound is triggered when the question tool starts executing. If a non-standard question channel is used, it will not be triggered.
  • If the sounds are too noisy, you can uninstall the plugin: dsh plugin --profile web remove dsh-chime.

This plugin is maintained by xiaxingtianxia2-glitch and is licensed under the MIT license. Source code and documentation are available on GitHub.