Introduction¶

The DSH plugin mechanism allows for display and interaction extensions around the Web UI. For developers working with agent workflows, a common issue is that session state changes are not easily noticed in time: some sessions are waiting for user input, while others have completed but have not been opened during your absence. dsh-web-attention-badge is designed to provide alerts for these states.

What Is This¶

dsh-web-attention-badge is a DSH plugin for the DeepSeek Harness Web UI that provides session notification capabilities. The GitHub repository is located at Luaphes/dsh-web-attention-badge and is licensed under MIT.

Core Features¶

This plugin provides three types of notifications in the Web UI:

• A badge styled as (1) displayed in the top-left corner of the interface.
• A (N) count shown in the browser tab title.
• A color change on the whale favicon.

Color states are as follows:

• Amber: Sessions waiting for user input, including ask_user, approvals, and plan-mode review.
• Green: Sessions that completed while you were away and have not been opened.

These notifications share the same count from the built-in sessions store—no host code, no additional transports. The badge is click-through and will not block the sidebar.

Installation and Updates¶

Installation command:

dsh plugin --profile web add dsh-web-attention-badge

The README also provides an example for installing from GitHub:

dsh plugin --profile web add "github:Luaphes/dsh-web-attention-badge#v0.3.1"

Update and removal commands are as follows:

dsh plugin --profile web update dsh-web-attention-badge
dsh plugin --profile web remove dsh-web-attention-badge

dsh plugin automatically registers the bundle, so no manual configuration is required.

Adjusting the Display¶

At the top of lib/client.js, you can adjust the following constants or style mappings:

• TAB_TITLE_ENABLED: The (N) prefix in the browser tab title.
• FAVICON_ENABLED: The whale favicon color change.
• The style mappings for AttentionBadge / Pill: Used to adjust the styles of corresponding elements.

The effect of changes differs:

• Bundle modifications require a page refresh.
• Manifest modifications require restarting dsh web.

Use Cases and Notes¶

Suitable for users who need to quickly confirm in the Web UI which sessions are waiting for input and which sessions have completed but have not been opened.

Before installation, it is recommended to review the repository source code, release references, dependencies, and confirm the license; this plugin runs with the permissions of the current dsh process, so it should only be integrated after verifying the source is trustworthy.

Conclusion¶

dsh-web-attention-badge places the two session states—“waiting for input” and “completed but unread”—into the interface badge, browser tab title, and favicon, making it easy to quickly locate sessions that need attention. GitHub repository:

https://github.com/Luaphes/dsh-web-attention-badge