AI Agent Hub
Back to plugins
🖥️

dsh-wsl-tray

Client Updated 2026.08.25

Run the following command in DeepSeek Harness:

dsh plugin install liyu34/dsh-wsl-tray

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

Run dsh plugin install liyu34/dsh-wsl-tray in your terminal to install; the source code is at https://github.com/liyu34/dsh-wsl-tray

About this plugin

Running a DSH Web server inside WSL is straightforward in itself, but every start, stop, or restart means bouncing between the Windows desktop and a WSL terminal with no immediate visual feedback. dsh-wsl-tray collapses that loop into a single desktop shortcut: double-click launches DSH fully in the background with zero console windows, and your default browser opens exactly once the moment the service answers.

Beyond the shortcut, a system-tray icon exposes a right-click menu for opening the web page, regenerating the shortcut, restarting the DSH service, pausing or resuming the watchdog, and exiting. Inside the tray process, a watchdog daemon probes the DSH URL every 10 seconds, clearly distinguishing refused connections, timeouts, and non-200 status codes in the log. Three consecutive failed probes mark the service as down and trigger a restart via wsl.exe; the watchdog then waits up to 180 seconds for a successful response. If three consecutive restarts fail, the watchdog pauses instead of looping indefinitely, and it can be resumed from the tray menu or automatically the instant DSH answers again. Every state transition is timestamped into watchdog.log and the current state-machine snapshot is written to watchdog-status.json, both viewable live on the DSH configuration card.

If you run DSH Web inside WSL and would rather manage it entirely from the Windows desktop—launching, monitoring, and auto-restarting without touching a terminal—this plugin bundles that start-monitor-restart loop into one shortcut and one tray icon. Place the shortcut in the Windows Startup folder and the watchdog follows you across reboots, keeping DSH ready the moment you sit down.

Use Cases

  • Double-click the desktop shortcut to launch DSH inside WSL in the background and open the browser automatically
  • Use the tray right-click menu to restart the service, pause, or resume the watchdog daemon
  • The watchdog auto-probes the DSH URL and triggers a restart on failure, removing the need for manual intervention

Best For

  • Developers who run DSH Web inside WSL and prefer managing it entirely from the Windows desktop
  • Users who want automatic recovery of a DSH service without sitting next to a terminal
  • Windows power users who prefer a zero-window, zero-terminal interaction workflow