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-status

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add @vlln/dsh-task-status

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

— source: plugins.install

Key points

• Node half: src/index.mjs (mirror patch + /tasks /output routes)
• client: src/client/task-status.tsx (dock-slot status bar)

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

Do I need to manually enable it after installation?

No. After installation and restarting the web profile, it takes effect on the chat page; you can temporarily disable or re-enable it in the Settings page's 'Plugins' panel.

On which pages will the status bar be displayed?

Only displayed in Chat view. Trajectory view, task board, and other pages will automatically hide it because these pages lack the chat flow column [data-chat-flow=""] probe.

The output area only shows 10 lines, what if I can't see earlier content?

A scrollbar automatically appears after 10 lines (160px), you can scroll up to see earlier output; the tail always keeps the latest content, making it convenient to observe progress.

Will the status bar compete for output with the official task_output tool?

No. The plugin adds a mirror patch to ctx.jobs.read: the official tool still reads in the original consumptive semantics, while the plugin itself reads via the underlying rawRead; both parties see the incremental sequence byte-by-byte consistent, with no duplicates or losses.

Where do the tasks shown in the status bar come from?

Comes from the union of host tasks - iterates through all agents to get their owned tasks, then merges with unowned tasks (deduplicated by id), and finally filters to active tasks (running/stopping) for the current session (matching ownerSession).

Why don't I see the status bar when I run background commands?

Check three points: ① Whether the tool actually has run_in_background: true set; ② Whether you're in Chat view (trajectory/taskboard won't display); ③ Whether you've restarted the web profile.

What happens when multiple tasks run simultaneously?

The status bar displays the total number of tasks and provides an 'Expand/Collapse' button; when expanded, it renders task rows one by one, and clicking on a single item allows you to view the real-time output tail of that task; when there are more than 5 items, the task list has its own scrolling.

— source: plugin_wiki.faq_json

Compatibility

• DSH: >=0.1.0-rc.5
• Node: >=22.19.0

— 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