Introduction

When handling multiple Sessions simultaneously in DeepSeek Harness (DSH), state is usually centralized on the DSH page. To confirm if a Session is still running, if attention is needed, or if it has completed or failed, one often has to return to the corresponding page to check.

dsh-traffic-light is a DSH plugin: it displays an independent floating traffic light on the desktop for Sessions that have monitoring enabled. It does not replace the DSH page but places the Session state outside of the page.

What is This

  • Plugin Name: yimeng-dev/dsh-traffic-light
  • Maintainer: yimeng-dev
  • Positioning: Provides a desktop traffic light for each Session in DeepSeek Harness
  • License: MIT
  • Current Status: README is marked as public beta
  • Environment Requirements: DeepSeek Harness must be installed and use the web profile

It solves the problem of not wanting to stare at the DSH page while running multiple Sessions in parallel, while still needing to quickly see the Session status.

Core Features

  • One Session corresponds to one floating light, and multiple Sessions can be displayed simultaneously.
  • The floating light is independently pinned and draggable, not occupying DSH page space.
  • Can be individually enabled or disabled from the Session’s three-dot menu, without affecting other Sessions in the same workspace.
  • Right-clicking the floating light and selecting “Close Floating Light” will sync the close action back to the DSH page.
  • Supports mapping five page states (Idle, Running, Attention, Completed, Failed) to three lights: Red, Yellow, and Green.
  • The floating light saves the on/off state per Session, not per workspace.
  • Sessions in different workspaces can also have floating lights enabled simultaneously.
  • Running status is only displayed locally; Session content is not uploaded.

Installation and Enablement

First, confirm that the current DSH is using the web profile, then execute:

dsh plugin --profile web add dsh-traffic-light

If the current DSH is already using the web profile, you can also use the shorthand:

dsh plugin add dsh-traffic-light

After installation, restart DSH Web:

dsh web

The first installation requires downloading Electron runtime components, so the package size will be larger than a normal web plugin. package.json specifies Node engines:

"^22.19.0 || >=24.0.0"

package.json declares dependencies:

"electron": "^43.4.0"
"@deepseek-ai/schemastery": "^3.18.1"

Typical Usage

  1. Open the Session to be monitored in DSH.
  2. Click the three-dot menu of that Session.
  3. Select “Enable Traffic Light”.
  4. A floating light corresponding to that Session will appear on the desktop.
  5. Repeat the above steps for other Sessions to monitor multiple Sessions simultaneously.

There are two ways to close a single floating light:

  • Select “Close Traffic Light” from the three-dot menu of the corresponding Session.
  • Right-click the floating light and select “Close Floating Light”.

To uninstall, execute:

dsh plugin --profile web remove dsh-traffic-light

Restart DSH Web after uninstalling.

Applicable Scenarios and Notes

  • Suitable for developers who need to view the status of multiple DSH Sessions simultaneously.
  • Suitable for scenarios where desktop status notifications are desired without occupying DSH page space.
  • DeepSeek Harness must be installed and use the web profile.
  • Currently verified mainly on macOS; Windows and Linux can be tried, but display effects may differ if the desktop environment limits transparent top-level windows.
  • The plugin only passes state between the local DSH and the desktop window; it does not upload Session content, prompts, or tool results.
  • The plugin runs with the permissions of the current dsh process. Source code and the MIT license should be checked before installation.

Conclusion

The value of dsh-traffic-light is concentrated: placing the DSH Session running status on a desktop floating light facilitates quick status judgment when running multiple Sessions in parallel.

Directory Page:

https://www.skillhub.cn/plugins/yimeng-dev/dsh-traffic-light

GitHub:

https://github.com/yimeng-dev/dsh-traffic-light