DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-pomodoro-timer

d

dsh-pomodoro-timer

Manifest valid

Pomodoro focus timer docked under the composer with long-break cycles, daily focus tracking, phase-change signals, and agent tools that read and control the timer. Its HTTP routes have no DSH access c

UI (client)hasBundlePatch
Kawaii tomato mascot

🍅 dsh-pomodoro-timer

A Pomodoro focus timer for the DeepSeek Harness Web UI — daily tracking, goals & streaks, phase-change signals, and agent tools.

English · Deutsch

npm version npm downloads Node.js version DSH rc releases MIT license

A DeepSeek Harness bundle that adds a Pomodoro focus timer to the web composer dock: a kawaii tomato pill under the chat input, a focus dialog with a progress ring and weekly chart, configurable durations in the General settings, phase-change signals, and three agent tools so your assistant can read, control, and analyze the timer.

Screenshots

Focus dialog (dark)Break dialog (light)
Focus dialog with progress ring, goal/streak and weekly chartLight-theme break dialog with green progress ring
Composer dock pillGeneral settings
Tomato pill under the composer next to session statisticsPomodoro settings rows: lengths, auto-start, signal, goal, agent, webhook
Phase-change toastMascot detail tiers
In-app toast announcing a completed focus phaseKawaii tomato at 56/32 px with face, clean silhouette at 20/14 px, break mood

The mascot keeps its full face at dialog size and degrades to a clean silhouette in the 14 px pill, so it never turns to mush. Break phases swap to a happy closed-eye expression; the ring is colored per phase (focus red, break green, long break amber).

Features

  • Composer dock pill — phase and remaining time next to the shipped session statistics; click opens the timer dialog (Start/Pause, Skip phase, Reset day).
  • Pomodoro cycle — 25 min focus → 5 min break, long break (15 min) after every 4th completed round; phases auto-continue or pause per setting.
  • Persistent tracking — completed rounds, focus time, history, and streak survive harness restarts (stored under $DSH_HOME/storages) and are shared across open tabs.
  • Goals & streaks — configurable daily goal, current streak, and a last-7-days bar chart in the dialog.
  • Phase-change signals — short beep (with a Preview button), optional desktop notification, and an in-app toast when a phase completes.
  • Agent integration — the model can see your focus state (opt-out), optionally gets a break hint when a round ends (opt-in), and a webhook POST fires on natural phase completion.
  • Settings (General section): durations, rounds before long break, automatic start, signals, daily goal, agent integration, webhook. UI in eight languages: English, German, Chinese, Russian, Japanese, Spanish, French, and Portuguese.
  • Agent tools — pomodoro_status, pomodoro_control, pomodoro_stats. UI buttons and tools run the same Host-owned state machine.
  • Protected page API — the HTTP bridge enforces DSH's Host/Origin fence and browser authentication on every request; POSTs must be application/json.

Requirements

  • DeepSeek Harness >=0.2.2-rc.1 <0.3.0 with a profile and web GUI; Node.js ≥ 24.9.
  • No build step and no install scripts.

Install

Ask your DSH agent to install it, or use the profile's plugin manager:

install_bundle: "@einfachllm/dsh-pomodoro-timer"

Or add the Discover index in Settings → Plugins → Discover:

https://raw.githubusercontent.com/einfachllm/dsh-pomodoro-timer/main/index.json

After installation, reload the web page — the tomato pill appears under the composer next to the session statistics.

Configuration

Settings → General:

RowControls
Pomodoro lengthsfocus / break / long-break minutes, rounds before long break
Start phases automaticallyall phases / breaks only / manually
Phase-change signalbeep (+ Preview), desktop notification
Daily goalrounds per day
Agent integrationfocus context (on by default), break hint (off by default)
Webhookoptional URL receiving a JSON phase_complete event

Tools

ToolPurpose
pomodoro_statusRead phase (idle/focus/break/long), running state, remaining ms, today's rounds/focus time, goal, streak, history.
pomodoro_controlstart, pause, skip (jump without counting), reset (clear today's tracking).
pomodoro_statsToday's totals, daily goal, streak, and per-day history (up to 30 days) with totals.

Deutsch

Ein DeepSeek-Harness-Bundle mit Pomodoro-Fokus-Timer im Composer-Dock: Kawaii-Tomaten-Pill unterm Eingabefeld, Fokus-Dialog mit Fortschrittsring und Wochenchart, persistente Tages-Tracks (Runden, Fokuszeit, Serie, Ziel), einstellbare Längen in den allgemeinen Einstellungen, Signalton/Desktop-Benachrichtigung/In-App-Toast beim Phasenwechsel sowie drei Agent-Tools (pomodoro_status, pomodoro_control, pomodoro_stats). Oberfläche in acht Sprachen: Deutsch, Englisch, Chinesisch, Russisch, Japanisch, Spanisch, Französisch und Portugiesisch.

Installation über den Plugin-Manager des Profils (npm-Spec @einfachllm/dsh-pomodoro-timer) oder über den Discover-Index, danach die Weboberfläche neu laden. Einstellungen → Allgemein → Pomodoro-Zeilen.

Development & publishing

Plain ES modules, no build step. node --check index.js client.js validates syntax. Releases are published to npm by GitHub Actions on v* tags (requires an NPM_TOKEN secret with publish access to the @einfachllm scope).

License

MIT

Comments

Loading…

Similar plugins

dsh-plugin-pomodoro

by atzx

Pomodoro focus timer plugin for DeepSeek Harness (DSH): a floating overlay timer with a Plugins-page configuration page, break cycles and desktop notifications. Browser-only DSH client plugin.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 19, 2026

dsh plugin --profile web add dsh-plugin-pomodoro

by cuznmop

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. · DSH Web 番茄钟:侧栏整页(专注/短休息/长休息)+ 输入框旁倒计时胶囊。

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 16, 2026

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

by EchoTint

Pomodoro timer for DSH with sidebar configuration, desktop widgets, focus statistics, and WebDAV/S3 backups.

UI & ExperienceManifest valid

★ 0

MIT

JavaScript

Nov 5, 2026

dsh plugin --profile web add @echotint/dsh-pomodoro

by dgy970516

A status bar in the composer footer showing the current phase, how long it has been running, the current step token count and a no-progress warning, projected from session logs without polling the hos

UI & ExperienceTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 19, 2026

dsh plugin --profile web add dsh-status-turbo

by yingrui96

An always-on attention pill in the session header. One glance shows how many sessions are waiting on you — approvals, questions, and failures — and what you already declined. Its HTTP routes have no D

UI & ExperienceManifest valid

★ 0

MIT

JavaScript

Nov 15, 2026

dsh plugin --profile web add dsh-attention-board

by causebefore

DeepSeek Harness Web 番茄钟插件:可配置专注与休息时长,提供侧栏入口和可拖动浮动面板

UI & ExperienceTerminal & ClientsManifest valid

★ 4

↓ 625/wk

MIT

JavaScript

Oct 1, 2026

dsh plugin --profile web add dsh-pomodoro