Skip to content
  • Home
  • Plugin manual
  • dsh-pomodoro

causebefore/dsh-pomodoro

30Last commit Aug 14, 2026

dsh-pomodoro DSH plugin

Adds a Pomodoro timer to the DSH Web UI sidebar with start, pause, reset, and skip controls. Supports configurable focus and break durations, automatic phase transitions, and cross-session timer recovery. The panel can be collapsed to a mini mode and adapts to DSH themes and locale.

ui-productivity

How to install the dsh-pomodoro DSH plugin

dsh plugin --profile web add dsh-pomodoro

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

dsh-pomodoro DSH plugin data source

dsh-pomodoro DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-pomodoro DSH plugin can do

  • Native DSH integration: opens from the sidebar and configures via DSH plugin settings
  • Complete timer controls: start, pause, reset, or skip a phase with circular progress and phase status
  • Cross-session recovery: timer resumes after reloading or reopening DSH, settling expired phases automatically
  • Low-distraction mini mode: collapses to phase, countdown, and primary control while retaining drag and expand
  • Configurable cycles: set independent focus and break durations, and choose automatic start for breaks or next focus
  • Completion feedback: in-app DSH reminder always shown; optional sound and system notifications
  • DSH language support: follows DSH global locale for Chinese and English without resetting the timer
  • Interface-aware: adapts to light/dark themes, keyboard operation, and reduced-motion preference

Where the dsh-pomodoro DSH plugin fits

  • Timeboxing focus sessions while working with DSH Web UI
  • Managing break intervals to maintain productivity and avoid burnout
  • Using the mini mode to keep a timer visible without cluttering the workspace
  • Recovering the timer state after accidentally closing the browser tab
  • Configuring automatic transitions for uninterrupted work cycles

Who the dsh-pomodoro DSH plugin is for

  • DSH Web profile users who want a built-in time management tool
  • Developers or researchers using DeepSeek Harness who follow the Pomodoro Technique

dsh-pomodoro DSH plugin limitations

  • Compatibility baseline is DSH 0.1.0-rc.6; DSH is still in developer preview, so compatibility may break after upgrades
  • Requires the DSH `web` profile; headless profiles do not provide the UI
  • System notifications only work when DSH is served from localhost, 127.0.0.1, or HTTPS, and the DSH page must remain open
  • Sound and system notifications are not delivered when all DSH pages are closed; the timer is settled on next launch
  • Only supports Chinese and English (follows DSH global locale)

dsh-pomodoro DSH plugin: from the repository README

Quoted from the causebefore/dsh-pomodoro README, the upstream source of the dsh-pomodoro DSH plugin. Copyright remains with the original authors.

> **Compatibility:** The current compatibility baseline is DeepSeek Harness `0.1.0-rc.6`. Harness is still in developer preview, so recheck plugin compatibility after upgrading DSH. ## Interface Preview Supports light and dark themes, a compact mini mode, and configuration through DSH plugin settings. <table> <tr> <th align="center">Light theme</th> <th align="center">Dark theme</th> </tr> <tr> <td align="center"><img src="https://raw.githubusercontent.com/causebefore/dsh-pomodoro/f57cde94489a3ddc9e066ce31d8b263de30c8799/docs/images/pomodoro-light-en.png" alt="Pomodoro floating panel in the light theme" width="250"></td> <td align="center"><img src="https://raw.githubusercontent.com/causebefore/dsh-pomodoro/f57cde94489a3ddc9e066ce31d8b263de30c8799/docs/images/pomodoro-dark-en.png" alt="Pomodoro floating panel in the dark theme" width="250"></td> </tr> </table> ### Mini mode <p align="center"> <img src="https://raw.githubusercontent.com/causebefore/dsh-pomodoro/f57cde94489a3ddc9e066ce31d8b263de30c8799/docs/images/pomodoro-mini-en.png" alt="Mini Pomodoro panel showing only the phase, countdown, and primary control" width="186"> </p> ### Settings <p al

Read the full READMERepository license: MIT

dsh-pomodoro DSH plugin questions

How do I install the Pomodoro plugin?

Run `dsh plugin --profile web add dsh-pomodoro` in your terminal. Then restart DSH Web with `dsh web`. The plugin is loaded when the 🍅 button appears at the bottom of the sidebar.

How do I start a Pomodoro session?

Click the 🍅 button in the sidebar to open the panel. Then click the Start button. The timer will begin the focus phase with the default duration (25 minutes). You can pause, reset, or skip phases using the controls in the panel.

Can I change the focus and break durations?

Yes. Open DSH Settings → Plugins → Plugin configuration → Pomodoro. There you can set Focus duration (1–240 minutes) and Break duration (1–240 minutes). Changes take effect immediately for a phase that hasn't started; otherwise they apply from the next phase.

Does the timer survive closing the browser tab?

Yes. The timer is cross-session. If you reload DSH or close and reopen the browser, the timer resumes from the original deadline. If the active phase expired while DSH was closed, it is settled once and reported on the next launch.

How do I enable sound or system notifications?

Go to the Pomodoro settings panel. Enable 'Play a sound when a phase ends' and/or 'Send system notifications in the background'. For system notifications, you must first allow notifications in your browser prompt. Notifications only work when DSH is served from localhost, 127.0.0.1, or HTTPS, and the DSH page must remain open.