ChenYichener/dsh-pomodoro ↗★ 0

dsh-pomodoro

DSH focus timer: a distraction-free Pomodoro panel in the sidebar with focus/short/long rounds, a per-round goal, daily stats and a completion log.

Package
dsh-pomodoro
Compatibility
Unverified
Version
0.1.0
License
MIT
Last updated
Nov 6, 2026

Other repositories with this package name

Install

$npx -p @deepseek-ai/dsh dsh plugin --profile web add github:ChenYichener/dsh-pomodoro

Usage

Open the Pomodoro entry in the sidebar. The shell selects main.pomodoro, which is the full-page timer.

ActionHowBehaviour
StartPrimary button (Start focus / Start break)Starts or resumes the current mode's countdown
Pause / resumeSame primary button (Pause / Resume)Pause freezes the remaining time; resume continues from it
Reset⟲ buttonStops the timer and restores the full duration of the current mode; today's stats are untouched
Skip⏭ buttonFocus → short break, or short/long break → focus. A skipped focus round does not count as a pomodoro
Pick a modeThe three tabs above the ringStops the timer and loads that mode's full duration
Set the goalText input under the ringSaved with the next completed pomodoro; stays for following rounds until you edit it
Change settingsFooter → SettingsSteppers per setting; changing the duration of the current idle mode updates the countdown immediately
View the logFooter → CompletedToday's rounds, newest first: time, goal (or "Writing focus"), minutes
Clear todayCompleted → Clear → confirmDrops today's pomodoros, focus time and log; also resets the round progress

There are no global keyboard shortcuts — the page is deliberately click-first and quiet. The countdown keeps running while you use other panels; a green badge on the sidebar icon shows that a round is in progress.