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.byIdandparentIdprovide subagent lineage.SessionListState.subagentsByParentprovides labels, modes, activity, and catalog health.workflow-runConversation 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