Foreword

The philosophy of DSH is “everything is a plugin.” Within a DeepSeek Harness session, user messages, assistant messages, tool calls, parallel calls, and sub-agent branches interweave in a single session flow; when reading linear messages, the process relationships, tool returns, and sub-agent execution progress are not very intuitive.

dsh-flowglass is a real-time session flow diagram plugin for DeepSeek Harness. It draws the current session as a three-column swimlane and supports sub-agent branching, drill-down, and detail viewing. Below, we first introduce its positioning and functions, followed by installation commands and typical usage.

What is This

dsh-flowglass is maintained by Iwctwbh and uses the MIT License. Its client platform is web and requires node >=22.19.

dsh-flowglass is the default product and default build target. It is a native static Host/Client plugin, does not use dynamicCordisRunner, and does not generate dyn/*. The full Toolbox secondary product dsh-dynamic-toolbox is independent of the default dsh-flowglass.

dsh-better-sidebar is an optional dependency.

Core Features

  • Three-column swimlane: The middle column is the user and assistant main line; tool calls are sent from the right side and returned from the left side.
  • Sub-agent branching: Sub-sessions expand their own branches and execution progress alongside the triggering step.
  • Drill-down: Enter any sub-agent session and navigate back level by level using breadcrumbs.
  • Parallel grouping: Parallel calls within the same step are displayed together, with running nodes continuously highlighted.
  • Full details: Click on a message or tool card to view the complete content, parameters, results, model, and token information.
  • Markdown assistant details: By default, uses the Harness official Markdown renderer to display tables, code blocks, lists, and math formulas.
  • Adjustable detail sidebar width: Drag the left edge or use the “Detail Width” slider in appearance settings; automatically remembered.
  • One-click copy: The “Copy” button in the title row of each content box in the details directly writes to the system clipboard.
  • Real-time refresh: By default, silently refreshes every 2 seconds; pauses when the page is not visible and resumes when returning to the page.
  • Optional integration: Can integrate with dsh-better-sidebar, registered as a native “Flow Glass” tab isolated by session.

Installation and Enablement

First, install dsh-flowglass:

dsh plugin --profile web add dsh-flowglass

After upgrading to a specified version, restart DSH:

dsh plugin --profile web add dsh-flowglass@<new version>

To uninstall, execute:

dsh plugin --profile web remove dsh-flowglass

If integrating with dsh-better-sidebar, install the sidebar first, then the Flow Glass:

dsh plugin --profile web add dsh-better-sidebar
dsh plugin --profile web add dsh-flowglass

Typical Usage

  1. After opening a DSH session, view the session main line in the three-column swimlane. The middle column is the user and assistant main line; tool calls are sent from the right side and returned from the left side.
  2. Click on a message or tool card to view the complete content, parameters, results, model, and token information.
  3. Enter any sub-agent session; sub-sessions expand their own branches and execution progress alongside the triggering step; use breadcrumbs to navigate back level by level.
  4. View parallel calls within the same step; running nodes will be continuously highlighted.
  5. View Markdown content in the assistant details, including tables, code blocks, lists, and math formulas.
  6. Adjust the detail sidebar width: drag the left edge, or use the “Detail Width” slider in appearance settings; the setting is automatically remembered.
  7. Use the “Copy” button in the title row of the detail content box to write content to the system clipboard.
  8. Keep the page open for silent refreshes every 2 seconds by default; pauses when the page is not visible and resumes when returning to the page.

Use Cases and Notes

dsh-flowglass is suitable for scenarios that require observing DSH session flow, tool calls, parallel calls, sub-agent execution, and model token information.

When installing and using, note:

  • The plugin runs with the current dsh process permissions; check the source code and license before installation.
  • The license is MIT.
  • The client platform is web and requires node >=22.19.
  • Dependencies include @deepseek-ai/dsh-client-ui-primitives ^0.1.1-rc.2, react ^18.3.1, react-dom ^18.3.1; dsh-better-sidebar >=0.4.0 is an optional dependency.
  • Internally retains toolboxRegistry, toolbox.* RPC, and .dsh-dynamic-toolbox/ data path for compatibility with existing frameworks and historical data; these internal names do not change the default installation entry point.
  • The static plugin does not use dynamicCordisRunner and does not generate dyn/*.

Links

GitHub Repository:

https://github.com/Iwctwbh/dsh-flowglass

The DSH community directory is an independent site with no official affiliation with DeepSeek /幻方; the information has been verified, and the directory page URL is not provided.