Introduction

DSH’s philosophy is “everything is a plugin”. The community directory is an independent site with no official affiliation with DeepSeek/Huansuan.

When there are multiple sessions, parent sessions, and child agents within the same workspace, it is not easy to quickly see the branch relationships in a plain text view. Below introduces dsh-branch-visualizer: a persistent DeepSeek Harness plugin for viewing native session branches and performing jumps, renaming, and archiving.

What is it

dsh-branch-visualizer is maintained by 111222cjyq and is released under the MIT License.

It reads the relationships of sessions, parent sessions, and child agents within the same workspace to automatically generate a tree layout, and provides session jumping, title modification, and archiving operations in the same interface.

The current status is Developer Preview. DeepSeek Harness itself is still in the experimental phase.

Core Features

Branch Tree and Canvas

  • Reads session, parent session, and child agent relationships within the same workspace to automatically generate a tree layout.
  • Supports dragging nodes, box selection, panning, zooming, auto-layout, and view centering.
  • Normal panels switch to circular nodes when effective zoom is below 0.6; the compact panel threshold is 0.85.

Session Jump

  • Double-click a normal node to open the session.
  • Child agent nodes use Harness’s jump address:
openSubagent

Status, Rename, and Archive

  • Distinguishes running, idle, cold, and listens to Agent lifecycle events.
  • Active sessions can be renamed directly.
  • Cold sessions are appended via persistent events and handle sequence conflicts.
  • Validates workspace ownership before archiving.
  • Batch archive results are returned item by item.
  • When archiving a parent node, its child agent descendants are collected.

Archive View

  • Archive nodes are not loaded by default.
  • A full view toggle is available.
  • When hiding the archive chain, the most recent visible ancestor is connected using double dashed lines.

Performance and Diagnostics

  • Uses snapshot TTL/LRU, same-key request merging, global rebuild concurrency limits, child agent TTL/LRU, and polling backoff.
  • Provides a de-identified diagnostic interface:
/brvis/api/diagnostics

This interface returns the adapter version, capability status, and missing capabilities.

Installation and Activation

Install to a specific profile from GitHub:

dsh plugin --profile <profile> add github:111222cjyq/dsh-branch-visualizer

Restart the corresponding Harness process after installation.

Typical Usage

  1. Open any session.
  2. Click “◈ Branch View” in the session title bar.
  3. Double-click a node to jump; drag nodes to adjust layout; pan the canvas with Space + Left Mouse Button.
  4. After selecting one or more nodes, perform renaming or archiving.
  5. Enable “Show Archive” when you need to check the full history.

Use Cases and Notes

This plugin is suitable for DSH users who need to view session branches, child agent relationships, and archive history within the same workspace.

Since it runs with the current dsh process, you should check the source code and MIT license before installing.

Current usage notes:

  • Currently only supports:
dsh.client.platform = web

Electron/desktop-specific bridge not verified.

  • The HTTP boundary is used to prevent ordinary cross-site browser requests, not local malicious process isolation or multi-user authentication systems.
  • Renaming cold sessions relies on the session event structure and is susceptible to changes in the Harness schema.
  • “Unarchive” is not yet provided.
  • Keyboard accessibility and touch gestures are still incomplete.
  • Does not include telemetry, ads, analytics SDKs, or third-party network requests.
  • Only accesses the local host via Harness’s same-origin interface:
/brvis/api

Links