Introduction

When running multiple sessions in DeepSeek Harness (DSH), the browser tab usually only shows a single whale icon, making it difficult to quickly distinguish which sessions are finished and which are still waiting for processing.

dsh-done-whale is a DSH plugin that transforms the whale icon in DeepSeek Harness tabs into a status light: green indicates a session has finished, amber indicates items waiting for processing, and black is the default state. It is compatible with the official version of DeepSeek Harness, uses the official plugin mechanism, and requires no extra dependencies.

What is it

The positioning of dsh-done-whale is to turn the whale icon in browser tabs into a session status indicator:

  • Green: A session finished while you weren’t looking.
  • Amber: A session has something to do waiting for you, such as asking questions, waiting for approval, or waiting for a plan review.
  • Black: Default state.

The license for this plugin is MIT. The repository address is https://github.com/wally8-8/dsh-done-whale.

Status Rules

The following lists the plugin’s color rules and synchronization relationships:

  • Green indicates a session finished while you weren’t looking.
  • Amber indicates a session has something to do waiting for you: asking questions, waiting for approval, or waiting for a plan review.
  • Black is the default state.
  • When both green and amber exist, show green.
  • The plugin only responds to the main session; sub-agent sessions will not change the color of the whale.
  • Colors use the same official signal as the green/amber dots in the sidebar to stay synchronized.

Installation and Activation

Before installation, ensure you are using the official version of DeepSeek Harness.

  1. Install the plugin:
dsh plugin --profile web add dsh-done-whale
  1. Restart Harness or refresh the page to apply.

Typical Usage

The following is the usage process organized according to the plugin description:

  1. Install the plugin:
dsh plugin --profile web add dsh-done-whale

  1. Restart Harness or refresh the page.

  2. When the tab whale turns green, it means a session finished while you weren’t looking.

  3. When the tab whale turns amber, it means a session has something to do waiting for you.

  4. After opening the corresponding session, the status automatically resets; it returns to black after viewing all of them.

  5. After handling the items corresponding to the amber status, the status automatically disappears.

  6. After refreshing the page, the whale returns to black: this is the memory semantics of the official “Completed Notification” and is a normal phenomenon.

  7. Uninstall the plugin:

dsh plugin --profile web remove dsh-done-whale

No traces remain after uninstallation.

Applicable Scenarios and Notes

Suitable for developers who need to monitor multiple DSH sessions simultaneously and wish to quickly determine session status in browser tabs.

Usage notes:

  • Requires the official version of DeepSeek Harness.
  • The plugin uses the official plugin mechanism and requires no extra dependencies.
  • Only responds to the main session; sub-agent sessions will not change the whale color.
  • When both green and amber exist, show green.
  • After refreshing the page, the whale returns to black; this is the memory semantics of the official “Completed Notification” and is a normal phenomenon.
  • The plugin runs with the permissions of the current dsh process; it is recommended to check the source code and MIT license before installing.

Links

  • Community Directory: https://www.skillhub.cn/plugins/wally8-8/dsh-done-whale
  • GitHub: https://github.com/wally8-8/dsh-done-whale