dsh-pomodoro-timer

dsh-pomodoro-timer

A Pomodoro timer for the DeepSeek Harness Web UI: a sidebar page with focus / short-break / long-break cycles, plus a countdown pill beside the composer.

English | 简体中文

Repository: https://github.com/cuznmop/dsh-pomodoro-timer · Issues: https://github.com/cuznmop/dsh-pomodoro-timer/issues · Package: https://www.npmjs.com/package/dsh-pomodoro-timer

Features

• Sidebar page — clock icon in the left panel list opens a full page with a progress ring, controls, and statistics.
• Composer pill — a compact countdown next to the message box; click it to jump to the page. It keeps running while you work in chat.
• Cycle control — focus 25 / short break 5 / long break 15 minutes by default, a long break every 4 pomodoros, and an optional auto-start for the next phase.
• Controls — start, pause, resume, reset the current phase, skip to the next phase.
• Statistics — the pomodoro number in the current round and how many you finished today; the counter rolls over at midnight.
• Chime — three short tones when a phase ends naturally (can be turned off; the page needs one interaction before the browser allows audio).
• Survives a reload — the running deadline is stored in localStorage, so refreshing the page resumes the same countdown.
• Light and dark themes — every colour is a --dsw-alias-* theme token; the plugin imports no Harness client package, so it does not break when those internals change.
• Bilingual — Simplified Chinese and English, following the GUI language.

Requirements

Install

# plain dsh web profile
dsh plugin --profile web add dsh-pomodoro-timer

In the Desktop app, install dsh-pomodoro-timer from the plugin market page, or from Settings → Plugins. Restart Harness (or reload the page) afterwards, then look for the clock icon in the sidebar panel list.

Usage

Changing a duration while a phase is paused resizes it immediately; while it is running, the change applies from the next phase.

State lives under the dsh.plugin.pomodoro-timer.v1 key in localStorage.

Uninstall

dsh plugin --profile web remove dsh-pomodoro-timer

Development

No build step: client.js is the published browser bundle. The package ships a self-contained offline check.

npm run check     # node --check on both halves + the offline bundle test
# pnpm run check works too. On a machine that only has DSH's bundled runtime, put
# the workspace shims on PATH first:  $env:PATH = "<workspace>\bin;$env:PATH"

test/client.test.mjs loads the browser bundle with a module-loader stub and a fake client context and exercises registration ids, the phase machine, persistence, and component rendering. It proves logic, not looks — visual verification needs the running GUI.

Layout

Notes

• The plugin reads and writes nothing but its own localStorage key. It has no host-side service, no tool, and no network access.
• It registers into sidebar.panellist, main, and conversation.composer.dock; it never replaces the app root and never appends to document.body.

License

MIT