AI Agent Hub
Back to plugins
🖥️

dsh-whale-tray

Client Updated 2026.09.11

Run the following command in DeepSeek Harness:

dsh plugin install zhqowo/dsh-whale-tray

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install zhqowo/dsh-whale-tray in the DeepSeek Harness terminal to install this plugin; the source repository is at https://github.com/zhqowo/dsh-whale-tray

About this plugin

Anyone who regularly uses DSH (DeepSeek Harness) knows the daily friction: start the service, stop it, then hunt through a dozen tab pages to find the web UI. dsh-whale-tray folds all of that into a tiny persistent whale icon — system tray on Windows, menu bar on macOS. A left-click silently switches to the existing DSH tab without opening a new window; a right-click pops a context menu with start, stop, restart, and billing shortcuts; the status badge auto-refreshes every two to three seconds. It feels like toggling a desktop client rather than typing CLI commands.

The launcher runs as a fully independent process, completely decoupled from the DSH backend — force-quitting the whale never affects DSH and vice versa. On Windows it signals a lightweight browser extension over a local port to surface a background tab; on macOS it drives Chromium-based browsers directly through AppleScript, skipping the extension entirely. Every action is silent, small-size icons are brightness-corrected for 16 px clarity, and the macOS build ships as a single .app you unzip and double-click.

If you lean on DSH for hours each day and are tired of retyping the same commands and flipping through tabs, dsh-whale-tray is that little whale sitting quietly in your corner, ready with one click. A single optional JSON config file lets you override the billing URL or DSH install path without recompiling anything.

Use Cases

  • One-click start and stop of the DSH service without touching the terminal
  • Silently summon the DSH web tab among dozens of open tabs without spawning a new window
  • Restart the DSH service from the tray with automatic port-release wait and clean retry

Best For

  • Heavy DSH users who start and stop the service several times daily on desktop
  • Engineers who prefer mouse-driven service control over repeated CLI invocations
  • Developers juggling DSH alongside other local tools and needing an always-visible quick-launch point