Introduction¶

In DeepSeek Harness Web, the running status of subagents is often scattered across the session tree, making it cumbersome to manually track active instances, view real-time output, or archive multiple sessions. This plugin addresses the problem by providing a centralized, searchable panel that allows developers to manage all subagents in a single view.

Plugin Overview¶

dsh-subagent-workspace-ui is a Web client plugin developed by miuzel. It adds a “Subagent Management” button to the conversation header action row. Clicking it opens a searchable panel that displays all subagents currently discovered by the DSH client runtime.

This plugin follows the MIT License.

Installation and Enablement¶

Install the package into the Web profile:

dsh plugin --profile web add dsh-subagent-workspace-ui

After installation, restart the existing dsh web process and refresh http://127.0.0.1:3080 to load the plugin.

Core Features¶

The plugin provides the following capabilities:

1. Views and Navigation

   • Displays a compact title bar trigger in the header, showing the number of active subagents and an activity status dot, so they can be perceived without opening the panel.
   • Shows subagents from the current workspace and current session by default, and updates automatically when switching.

2. Search and Filtering

   • Supports searching by name, title, or workspace name. Using the id: prefix searches only session IDs (for example, id: graph:g-a92e1406).
   • Supports grouping by session, workspace, or type, or sorting by recent activity, name, or type.
   • Provides category tabs (such as All, Other, Review, Testing, etc.). One-off subagents carry a ⚡ One-off badge.

3. Subagent Control

   • Supports pausing and resuming individual subagents.
   • Supports pausing active subagent groups with one click.
   • Supports batch operations: archive, restore, select all, and time-based batch selection (supports up to 1000 entries).

4. Real-Time Information

   • Active subagents are gathered in a collapsible top area.
   • Shows the latest two lines of real-time output, tool calls, context injections, and command status for each running subagent.
   • Displays termination status using status indicators: normal termination is shown as a green hollow ring, while abnormal termination (stopped/error/blocked, etc.) is shown as a red solid dot.

Notes¶

• No build flag required: The published package includes prebuilt lib/, so the --allow-build flag is not required during installation.
• UI adaptation: The plugin includes cordis.patch.yml, used to override the default conversation.session.header.lineage, while keeping the standard ui-subagent plugin enabled and providing a sidebar navigation entry.
• Filtering mechanism: Filtering and hiding are plugin-local features. Hidden subagents are only removed from the list; they do not delete DSH sessions or workspace files.