Skip to content
  • Home
  • Plugin manual
  • dsh-task-status

vlln/dsh-task-status

100Last commit Aug 15, 2026

dsh-task-status DSH plugin

The task-status plugin adds a dock card above the conversation input area showing the count of running background tasks. Clicking a task row expands to show status, duration, details, and a live output tail that polls every 1 second. It is installed as an official bundle plugin (dsh.bundle + dshClient) with zero patches.

ui-productivity

How to install the dsh-task-status DSH plugin

dsh plugin --profile web add "github:vlln/dsh-task-status#main

Copying does not run this command. Review the repository and version before installing the dsh-task-status DSH plugin.

dsh-task-status DSH plugin data source

dsh-task-status DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-task-status DSH plugin can do

  • Displays a status bar with the count of running background tasks.
  • Click to expand each task for details, status, duration, and a live output tail (polling every 1 second, max 10 lines scrollable).
  • Provides read-only routes `/tasks` (task list) and `/output` (task output tail) for programmatic access.
  • Uses a mirror patch to avoid competition with the official `task_output` tool, ensuring consistent view.

Where the dsh-task-status DSH plugin fits

  • Monitor background tasks while chatting in the conversation page.
  • Debug long-running scripts by viewing the live output tail.
  • Track multiple concurrent background tasks with expandable details.
  • Quickly check task status without leaving the conversation view.

Who the dsh-task-status DSH plugin is for

  • DSH users who run background tasks and need real-time progress feedback.
  • Developers debugging or monitoring script execution in the chat interface.

dsh-task-status DSH plugin limitations

  • Only visible in the conversation view; hidden in trajectory, taskboard, and other non-Chat views.
  • Output tail limited to 10 lines (160px); older lines scroll out of view.
  • Requires background tasks to be created (e.g., via `run_in_background: true` with bash tool).

dsh-task-status DSH plugin: from the repository README

Quoted from the vlln/dsh-task-status README, the upstream source of the dsh-task-status DSH plugin. Copyright remains with the original authors.

对话页输入框上方的后台任务状态条：运行中任务计数 + 点击展开逐条详情 + **实时输出 tail**（自动轮询，10 行滚动区）。经官方 `conversation.input.dock` 槽注册（与 queue/todo/goal 同族）。形态：官方 **bundle 插件**（`dsh.bundle` + dshClient 通道），0 patch。 ## 效果 ![task-status（真实运行截图：任务行 + 展开输出 tail）](docs/preview/task-status.png) ## 能力 **UI**（对话页 dock 槽）： | 功能 | 说明 | |---|---| | 状态条 | 对话页输入框上方 dock 卡片：`⚙ N 个后台任务运行中` | | 展开详情 | 点击任务行展开：状态/耗时/详情 + 输出 tail | | 实时 tail | 展开时每 1s 轮询输出路由，整段替换渲染（镜像补丁保证与官方 `task_output` 工具零竞争、视图一致） | | 滚动区 | 输出区 max 10 行（160px），超出变滚动条（tail 保尾可回看） | | 仅对话页 | 非 Chat 视图（trajectory/taskboard 等）自动隐藏 | **路由**（Node half）： | 路由 | 说明 | |---|---| | `/plugins/dsh-task-status/tasks` | 任务列表（只读，按 session 过滤；owned + unowned 并集） | | `/plugins/dsh-task-status/output` | 任务输出 tail（`full:true` 累积全文；未知 id 404） | **输出 tail 的竞争语义**（0809 官方 API 约束）：`tasks.read` 是消耗式增量（每任务唯一共享游标）。本插件给 `ctx.tasks.read` 打**镜像补丁**——官方 read = 缓冲镜像（他人已读增量，不重复消耗）+ 直读补最新（正常消耗）；插件自读直接走底层 rawRead。官方工具与插件看到同一增量序列（无重复无丢失），仅主动自读部分官方不再能单独重放（官方语义本就是增量读取，模型感知无影响）。 ## 安装 **推荐：git 源一行安装**（构建产物已入库，git 源不触发构建）： ```sh dsh plugin --profile web add "github:vlln/dsh-task-status#main" ``` 或本地目录（有源码时）：`git clone` 后 `cd dsh-task-status && dsh plugin --profile web add .`。 装完 **重启 web**

Read the full READMERepository license: MIT

dsh-task-status DSH plugin questions

How do I install the task-status plugin?

Run `dsh plugin --profile web add "github:vlln/dsh-task-status#main"` in your terminal. After installation, restart the web interface to activate it. You can also manage it from the plugin panel in settings.

Can I see the task status in non-conversation views?

No, the plugin is only visible in the conversation view. It automatically hides when you switch to trajectory, taskboard, or other non-Chat views.

How do I trigger a background task to see the status bar?

You need to run a task with `run_in_background: true`, for example using the bash tool. The status bar will appear showing the count of running tasks. Clicking a task row expands it to show details and live output.

Does the plugin conflict with the official task_output tool?

No, it uses a mirror patch to ensure zero competition. The official tool and the plugin see the same incremental output sequence, with no duplication or loss.

Can I customize the number of displayed output lines?

The output tail is fixed at a maximum of 10 lines (160px height). If there are more lines, a scrollbar appears. You cannot change this limit without modifying the plugin source code.