Skip to main content

How to use dsh-task-dag

Added a "Task DAG" entry to the DSH Web session title bar, rendering the current session, delegated sub-agents, and persistent workflows as a real-time navigable dependency graph.

This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

dsh-task-dag

— source: plugin_wiki.wiki_content

Install & verify

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

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

  • SessionListState.byId and parentId provide subagent lineage.
  • SessionListState.subagentsByParent provides labels, modes, activity, and catalog health.
  • workflow-run Conversation Nodes provide workflow phases, members, and outcomes.

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

What to do if the 'Task DAG' entry is not visible in the session after installation?

Confirm the current profile is web (dsh plugin --profile web add ...), after the first installation you need to restart the dsh web process once and refresh the page, secondary startups or updates generally don't require a restart.

What to do if nodes cannot be clicked to open their corresponding sessions?

Only sub-agent nodes that still appear in the DSH Session list are navigable; nodes in archived, deleted, or invisible sessions will not respond to clicks.

If I drag a node to adjust its position, will it be retained in the next session?

It is only retained in the current page's React state within the current Session. After switching Sessions, refreshing the page, or restarting DSH, it will revert to the deterministic automatic layout calculated by the plugin. The workflow topology itself is still reconstructed from persistent data.

Will this plugin read my files, connect to the network, or inject prompts?

No. This is a read-only visualization plugin within the browser that does not read workspace files, send network requests, register model tools, or persist session content and credentials.

Does it support CLI / Desktop profile?

Not supported. The dsh.client.platform in package.json explicitly declares "web", and cordis.patch.yml only registers the task-dag client plugin.

What to do if the status/labels in the graph look outdated?

Clicking the "Refresh" button on the graph panel will re-fetch the observed sub-agent directory; workflow nodes are always driven by persistent data projection and will not be rearranged as a result.

How to uninstall?

Run dsh plugin --profile web remove dsh-task-dag, then restart dsh web once.

— source: plugin_wiki.faq_json

Compatibility

  • DSH: 未声明
  • Node: >=20

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule