READMESource: main@199e8baa
Session todo marks for DeepSeek Harness
English | 中文
Marks the Sessions you left half-finished, so an interrupted task does not get lost in the sidebar.

一句话安装指南
点击 DeepSeek Harness “插件”界面的“添加插件”,输入
https://github.com/Ye-nile/dsh-to-do-marks
或者
github:Ye-nile/dsh-to-do-marks
即可
What it does
- Dot beside the Session name when that Session still has unfinished agent todos or when you marked it for follow-up. One signal, one meaning: this Session needs you back. Removing the follow-up mark clears the dot immediately; an auto summary never affects it.
- Hover the Session row to see up to four unfinished agent todos, with the
in_progressone highlighted and a "N more" line beyond that. - Auto summary: a followed-up Session gets an Auto-summarize switch in its row menu. Turning it on reads the recent conversation on the Host and asks the Session's own model for at most four short follow-up items, shown in the hover card with a Summarize again action. Turning the switch off clears them. The summary is independent state: removing the follow-up mark leaves it untouched, and the switch stays reachable so it can always be turned off.
- Row "..." menu gains three entries:
- Mark for follow-up / Stop following up — a durable, manual mark that works
even for Sessions whose agent never used
todo_write. - Auto-summarize — the switch above.
- Ignore these todos / Show these todos again — dismisses the current agent todo list only; the dot returns automatically when the agent rewrites the list.
- Mark for follow-up / Stop following up — a durable, manual mark that works
even for Sessions whose agent never used
Summary format
The model is instructed to output only the bullet lines:
- at most four items, fewer when fewer are warranted — never padded to fill the list;
- most important first;
- one sentence per item, naming a concrete action;
- no elaboration, no examples, no repeating the conversation's wording, no filler.
The Host strips bullets, quotes, and code markers from the reply, de-duplicates, and keeps the first four items.
Install
Requires a profile that ships the Web server, the model service, and the
session-persistence service; the standard Desktop and dsh web profiles do.
git clone https://github.com/Ye-nile/dsh-to-do-marks.git
- Open Plugins in DSH and choose Add plugin.
- Pick the cloned directory.
- Reload the page if the manager reports that a restart is required.
Data and privacy
- Unfinished agent todos are read from the Session-list projection value (
todos) that the client already receives for every row. That path adds no requests, no polling, no timers, and no log scans. - Marks and summaries are the only durable state. They live in
<DSH_HOME>/storages/session-todo-marks.jsonand reach the page through the Host half's/session-todo-marksloopback route. Nothing leaves the machine. - Auto summary is explicit: one model call when you turn the switch on and one per Summarize again. It reads at most the last twelve messages of that Session, uses that Session's own provider and model at the route's lowest reasoning effort, and never runs on its own.
Limitations
- Only Sessions whose agent called
todo_writeget the automatic todo dot. For everything else, Mark for follow-up is the manual path. - The dot uses the row's leading seat, which the UI reserves for status while a Session is running or waiting for approval; those rows show their status dot instead.
- The
todosprojection resets when a new turn starts, so the agent-todo dot disappears once you go back and continue the conversation. That is intended: you either remembered it or the agent rewrites the list. - The summary is generated when you turn the switch on (or press Summarize again); it is not refreshed automatically after later turns, and its items are read-only.
- Archived rows and subagent Sessions do not render the mark.
- The collapsed sidebar keeps the build's own desktop-update badge:
sidebar.toggle.badgeis a single-occupant slot, and shadowing it would hide that shipped notice, so this plugin does not add a collapsed count.
Development
No build step, no dependencies. The package is a DSH bundle:
| File | Role |
|---|---|
index.js |
Host half: /session-todo-marks route, JSON state, auto-summary call |
client.js |
Browser half: module-loader factory registering five slots |
cordis.patch.yml |
Inserts the Host row |
locale/*.json |
Plugin Manager title and description |
test/smoke.mjs |
Contract test: endpoints, persistence, model stub, registrations, rendering |
npm test
The smoke test stubs the model and the session log, so it runs offline; it exercises the real route handler with synthetic requests instead of starting a server.
Publishing
- The manifest already points at https://github.com/Ye-nile/dsh-to-do-marks.
- Remove
"private": trueif you also want to publish the package to npm.
License
MIT
No comments yet. Be the first to write one.