dsh-task-dag: A Live Task Topology Visualization DSH plugin for DeepSeek Harness

dsh-task-dag is a DSH plugin for DeepSeek Harness that provides persistent live DAG visualization for subagents and workflows in DSH Web. It addresses the challenge of tracking delegated subagents and durable workflows in complex sessions by transforming DSH's existing Client projections into a top-to-bottom dependency graph, without maintaining a parallel workflow database or sending polling requests—the graph updates as Session state changes. Core capabilities include live topology, durable workflow reconstruction, clear ownership grouping, direct navigation, canvas control, bounded layout persistence, robust projection, native presentation, and lifecycle safety. Maintained by LeemanCheung under the MIT license, last updated in 2026-08, and built with JavaScript.

What core features does the dsh-task-dag DSH plugin support?

The plugin offers live topology that reacts to Session and subagent catalog snapshots without Host polling. It supports durable workflows by reconstructing workflow phases and members from workflow-run Conversation Nodes, even after restart. Clear ownership groups workflow members under workflow nodes instead of drawing duplicate root-to-child edges. Direct navigation opens healthy, list-visible subagent Sessions from their graph nodes. Canvas control fits the whole graph or pans the original-size canvas; nodes can be dragged and keep their rearranged positions while the current Session panel is reopened. Bounded layout persistence means manual node positions live only in the current page's current-Session React state; switching Sessions, refreshing the page, or restarting DSH restores deterministic automatic layout, while workflow topology itself is rebuilt from durable Conversation Nodes. Robust projection rejects broken or cyclic lineage while retaining deterministic layers for valid deep dependency chains. Native presentation uses DSH theme semantics, restrained status colors, and custom SVG icons in light and dark modes. Lifecycle safety registers UI and styles through Cordis lifecycle ownership and removes them on unload.

How to install dsh-task-dag?

Use the following command to install, then restart the DSH Web process once and refresh the page. The Task DAG action appears in the Session header.

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

For a version-pinned installation:

dsh plugin --profile web add github:leemancheung/dsh-task-dag#v1.2.0

How to use the dsh-task-dag graph interface?

Select Task DAG to open the Session-scoped graph panel and enable related parent catalogs. Drag the empty canvas to pan the scrollable original-size canvas; drag a node to rearrange it while edges stay in sync, and the layout survives close and reopen for the current Session. Select a subagent node or press Enter / Space to open that Session when available. Toggle fit mode to switch between a whole-graph overview and the original scrollable canvas. Refresh updates observed subagent catalogs; workflow nodes remain projection-driven. Drag the title bar to reposition the panel without capturing toolbar controls. Press Escape or select close to close the panel and restore focus.

Which DeepSeek Harness versions and platforms does dsh-task-dag support?

The plugin is designed for DeepSeek Harness Web and depends on @deepseek-ai/dsh-client-locale, @deepseek-ai/dsh-client-runtime, @deepseek-ai/dsh-client-ui-conversation, @deepseek-ai/dsh-client-ui-primitives, and @deepseek-ai/dsh-client-ui-workflow-run, ensuring tight integration with the DSH client ecosystem. It uses Cordis lifecycle management, is compatible with DSH's plugin system, and follows the official dsh.bundle manifest.

See more DSH plugins at dsh-plugin.org