Foreword

When handling agent tasks in DeepSeek Harness (DSH), Sessions, delegated subagents, Agent Teams, Agent communication, and Workflows are often scattered across different states. If you only look at a single message or a single Session, it’s easy to miss task dependencies, member collaboration, and Workflow execution progress.

dsh-task-dag is a DSH Web plugin maintained by LeemanCheung. It rebuilds the existing DSH Client projections into three interactive topology views: Overview, Agent Teams, and Workflow. Below, we’ll introduce its positioning, installation method, typical usage, and usage boundaries.

What is this

The positioning of dsh-task-dag is: Live Agent Teams task, communication, subagent, and Workflow topology for DeepSeek Harness.

It addresses the visualization problem in the current DSH Web interface: putting the current Session, ordinary delegated subagents, Team members and tasks, Agent communication, and Workflow runs into a single view for inspection. The plugin does not introduce a parallel orchestration database, nor does it send polling requests; it relies on the Client projections that DSH already possesses.

Core Features

Overview

The Overview view displays the following:

  • Current Session
  • Ordinary delegated subagents
  • Team members and tasks
  • Agent communication
  • Workflow runs

This view serves as an entry point, allowing you to first confirm which subagents, team tasks, and Workflow runs are present around the current Session.

Agent Teams

The Agent Teams view displays:

  • Team Lead and teammates
  • Task assignment
  • Shared-task blockedBy DAG
  • Optional communication overlay

There is a boundary here: dsh-task-dag visualizes Agent Teams records, but it does not install or create the Agent Teams runtime. Agent Teams are described as an upstream experimental capability and may not be mounted by every stock DSH Web profile.

Furthermore, the Host composition must first emit supported Team events for data to appear in the Agent Teams view. Without these events, this view may have no content to display.

Workflow

The Workflow view displays:

  • Durable Workflow run
  • Phase grouping
  • Started member Sessions

Here, the phase edges are for presentation grouping, not for script dependency edges. In other words, they are used to display phase grouping and do not represent script execution dependencies.

After selecting a Workflow run node, you can open a read-only definition inspector to view metadata, declared phases, the complete JavaScript body, and use copy controls. The definition preview deliberately does not project runtime args.

Agent Communication

Agent communication channels aggregate message count and queued delivery state.

After selecting a channel, you can view the latest 100 message records and see quiet/wakeup and delivery metadata.

The plugin also supports the following interactions:

  • You can select a teammate, subagent, or Workflow member node; if the corresponding Session is still visible in the Session list, you can directly open that Session.
  • The canvas supports fitting the entire topology, panning the original-size canvas, and dragging nodes; when dragging nodes, connected edges update synchronously.
  • Within the current Session, per-view manual layout is preserved across view switches and panel reopens; after switching Sessions, refreshing, or restarting DSH, the automatic layout is restored.
  • The panel uses DSH semantic theme tokens, accessible status labels, edge line styles, responsive communication details, and reduced-motion behavior.

Installation and Enablement

First, install the plugin using the following command. This command uses the DSH Web profile:

dsh plugin --profile web add github:LeemanCheung/dsh-task-dag

After installation, restart the current DSH Web process once, then refresh the page. After refreshing, a Task DAG action will appear in the Session header.

If you need to install a fixed version v1.4.0, use the following command:

dsh plugin --profile web add github:LeemanCheung/dsh-task-dag#v1.4.0

Typical Usage

The following steps are described for operations within the current DSH Web Session.

  1. Select Task DAG to open the graph for the current Session and refresh the observed subagent catalogs.

  2. Switch between the Overview, Agent Teams, or Workflow topologies. Switching will not discard the manual layouts of other views on the current page.

  3. Toggle the message icon to show or hide Agent communication. This step does not change the task layout.

  4. Select a communication edge to open its directed message timeline. When focus is on the edge, both Enter and Space can trigger it.

  5. Select a Workflow run node to open the read-only definition inspector to view metadata, declared phases, the complete JavaScript body, and copy controls. Enter and Space are supported.

  6. Select an Agent node; if its corresponding Session is available in the Session list, open that Session. Enter and Space are supported.

  7. Drag the empty canvas to pan the original-size canvas; drag a single node to adjust its position, while edges update synchronously.

  8. To reproduce a Workflow check: create a new top-level Session, invoke the workflow tool from that Session, then open Task DAG → Workflow.

Suitable Scenarios and Notes

This plugin is suitable for developers handling multiple subagents, Agent Teams, or Workflows in DSH Web. It is better suited as a viewing tool to understand the topology, task dependencies, communication status, and Workflow definitions of the current Session.

Please note the following before use:

  • This plugin integrates into the current Web environment via the DSH plugin mechanism and will run with the permissions of the current dsh process; check the source code and license before installation.
  • Dialogs do not trap focus and do not provide keyboard dragging for the panel, canvas, or nodes.
  • The data in the Agent Teams view depends on the Host composition emitting supported Team events.
  • Workflow phase edges only represent presentation grouping, not script dependencies.
  • The Workflow definition preview displays the complete JavaScript body but does not project runtime args.

Conclusion

The value of dsh-task-dag is to place the subagents, Agent Teams, Agent communication, and Workflow within the current DSH Web Session onto a single interactive graph, reducing the need to switch back and forth between different state views.

The directory page is a community plugin directory, not an official app store.

  • Directory page: https://www.skillhub.cn/plugins/LeemanCheung/dsh-task-dag
  • GitHub: https://github.com/LeemanCheung/dsh-task-dag