dsh-plugin-trellis-statusline
在 dsh 网页聊天中显示当前工作区的活动 Trellis 任务，包括父任务/子任务角色以及可点击的任务树。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:CJ-SH/dsh-plugin-trellis-statusline#90a4aa1db12efe008f570fbe4cf095da24497751Plugin Trellis Statusline 以 dsh-plugin-trellis-statusline 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Show the active Trellis task of the current workspace in
the dsh web chat — the job the Claude Code
statusline.py hook does in a terminal, and a statusline dsh's web shell does not have.
This one is a statusline: a single compact pill, always visible, in the chat you are already looking at.
[P2] Add the importer · 进行中
[P1] Release 0.2 · 进行中 · 父任务
[P2] Wire the importer · 进行中 · 子任务
Trellis keeps each piece of work as a task under .trellis/tasks/ and records which one a
session is on. dsh's web shell shows the workspace and the model, but not the task — so you have to
switch back to a terminal, or ask the agent, to find out what you are actually working on.
This plugin puts that fact in the chat:
It is a pure read: it never writes to Trellis, starts or archives nothing, and shows nothing at all when there is no task.
| dsh | with the web profile. Verified against 0.1.5-rc.2; the seats it attaches to are internal, so a dsh upgrade may move them — see Troubleshooting |
| Node | ^22.19.0 || >=24.0.0 |
| A Trellis-managed workspace | dsh is Trellis' 22nd supported platform — run trellis init --dsh in the workspace (Trellis docs). The session's working directory then contains .trellis/, which is all this plugin reads |
It needs no Python and no trellis CLI at runtime. Unlike plugins that drive task.py, this one
only reads the JSON Trellis writes.
This package is a dsh bundle: it declares dsh.bundle with a cordis.patch.yml, and installing
it appends the bundle to the profile and applies its patch layer
(official guide).
From npm — not published yet, this is the command once it is:
dsh plugin --profile web add dsh-plugin-trellis-statusline
Today, install straight from the repository. Either a clone:
git clone https://github.com/CJ-SH/dsh-plugin-trellis-statusline
dsh plugin --profile web add ./dsh-plugin-trellis-statusline
…or the git URL, which needs no clone of your own:
dsh plugin --profile web add github:CJ-SH/dsh-plugin-trellis-statusline
The git route works here without the usual prepare script and allowBuilds allowance, because
there is nothing to build: lib/ is plain JavaScript committed to the repository, so a git install
already fetches runnable artifacts. A plugin written in TypeScript would need both, and the
allowance is permission to run its code on your machine at install time — see
the official note.
Then check the row landed and restart dsh — loading a plugin happens at boot, and the restart ends any agent process, so run it yourself:
dsh --profile web --dump-config | grep trellis-statusline
A working install needs no configuration: the plugin reads the session it is rendered in and holds no settings.
dsh plugin --profile web remove dsh-plugin-trellis-statusline
It stores nothing, so uninstalling needs no cleanup.
The patch inserts one loader row and nothing else. The Host half registers its own route on the
composition's webServer and asks connection for the trust fence before every answer
(requestRejection → 401/403, and 503 when that seam is missing) — the same shape the
shipped dsh-host-open-in-app uses.
An earlier version widened the shipped connection row's inject instead. That is what
connection.rpc.handle needs — it registers its physical route on that row's context — and it
made this plugin's availability depend on a piece of another bundle's configuration and on layer
order. Owning the route removes the coupling: nothing here can be silently taken away by a patch
collision.
The pill reads [priority] title · status. Three shapes, depending on the task:
| The session's task is | The pill reads |
|---|---|
| standing alone | [P2] Title · 进行中 — no role, no click target, no tab stop |
| the tree's root | [P1] Title · 进行中 · 父任务 |
| anywhere else in the tree | [P2] Title · 进行中 · 子任务 |
Only two roles exist. The tree's top ancestor is the one and only 父任务; every other member — grandchildren included — is a 子任务. Depth never changes the wording, so a deep tree stays readable.
When the task is in a tree the pill becomes clickable. The dropdown shows the real structure (one indent level per depth, with a guide line) and highlights the session's task. A stand-alone task is not clickable at all — no button, no focus ring, no tab stop.
The display refreshes every 10 s, and immediately when the header switches to another session, so a
task.py start or task.py archive shows up within one poll.
.trellis/.runtime/sessions/dsh_<sessionId>.json, which
task.py start writes. It wins whenever it names a real task..trellis/tasks/*/task.json — in_progress before planning, and among equals
the newest MM-DD- task. A scanned task must also have been started at least once, which a
recorded branch proves.That last rule earns its keep: trellis init leaves a scaffolding task (Bootstrap Guidelines) at
status: in_progress with no branch, forever. Without the check, every fresh Trellis project
would report it as active work — four of the five real workspaces this was built against had
exactly that stale task. See design notes.
node:fs/promises for readFile and readdir and
holds no write path at all; the self-check proves a full read leaves .trellis/ byte-identical.task.py's job. The dropdown is a view,
not a control: its rows are not clickable.review task found by the scan (the pointer still displays it,
as 审核中 / in review). Widen RUNNING_STATUSES in lib/index.js to change that.Nothing appears at all. In order of likelihood: the workspace has no .trellis/; it has one but
no task was ever started in it (see the branch rule); you are in the
new-session view and the composer could not be measured; another bundle claims the exact route
/trellis-statusline/task/read (the Host logs [trellis-statusline] route unavailable at boot);
or a dsh upgrade moved the seats. The plugin never shows a placeholder and never reports an error —
an absent pill is the failure mode, by design.
It shows the wrong task. Check python ./.trellis/scripts/task.py current --source. If that
disagrees with the pill, the plugin's scan and Trellis' pointer resolution have diverged — please
open an issue with both.
It shows the workspace's newest task instead of the one you started. If dsh was launched from
inside another Trellis session — a Claude Code or Codex window, say — Trellis 0.6.15 inherits that
session's TRELLIS_CONTEXT_ID and can write the runtime pointer under the outer context key
(the general case is tracked upstream, mindfold-ai/Trellis#549;
Trellis 0.6.15 fixed it for dsh specifically). This plugin then finds no
pointer for its own session and falls back to the workspace scan — which is precisely why that
fallback exists. Unset TRELLIS_CONTEXT_ID before starting dsh, or run
python ./.trellis/scripts/task.py start .trellis/tasks/<dir> in the dsh session itself.
It appears in one session but not another. That is the design: each session reports its own working directory, so parallel sessions in different workspaces show different tasks.
No dependencies and no build step: the browser half is written directly in the form the shell
consumes, the Host half imports nothing beyond node: builtins, and the suite asserts both.
node --check lib/index.js && node --check lib/client.js # both halves parse
npm test # 197 assertions, four harnesses
The harnesses live in the repository, not in the published tarball — files ships only lib, the
patch, the README, the design notes and the licence — so run npm test from a checkout.
| Harness | Covers |
|---|---|
test/host.test.mjs | resolving the task against throwaway workspaces: pointer first, scan fallback, ranking, the branch rule, every tree case, and a before/after hash proof that a read never writes |
test/client.test.mjs | the bundle contract: id, the react-only require, both seats (slot key vs cell id vs order), locale namespace, stylesheet lifecycle, cross-half constants |
test/cell.test.mjs | the real cells under a minimal hook runtime: all three pill shapes, the dropdown and its dismissal routes, the Hero cell's blank-session gating and measured position, listener and interval cleanup |
test/integration.test.mjs | the two halves against each other — the real Host half reads a real .trellis tree and that exact reply is fed to the real cell, so a wire-shape drift cannot pass unnoticed |
| File | Role |
|---|---|
lib/index.js | Host half — session → cwd → task, and the /trellis-statusline/task/read route |
lib/client.js | Browser half — the module-loader bundle, the seat registrations, the cell |
cordis.patch.yml | the loader row; no other bundle's row is patched |
docs/design-notes.md | why it works this way: the seats, the measurement, the derivation rules |
MIT © 2026 HenTaiCJN
Trellis is a separate project by Mindfold LLC, licensed
AGPL-3.0-only. This plugin is not affiliated with it, and neither bundles nor derives from its
code: it reads the .trellis/ files Trellis writes.