Focus sessions with timed breaks

Pick a phase with the tabs, then press Start. The ring empties as the phase runs and the remaining time also appears in the browser tab title, so the countdown stays readable while the page sits in the background. Pause holds the time left, Reset clears the phase without recording it, and Skip moves to the next phase without counting the one you leave. Full screen expands the timer stage to fill the display, which suits a second monitor or a phone propped on the desk.

Three presets set all three lengths at once: 25/5, 50/10 and 52/17. Any length can also be typed in, from one minute to 120, and a long break arrives after every fourth completed focus session rather than a break you choose. A duration edited part-way through a phase applies the next time a phase starts, so the ring already running is never rescaled. Two checkboxes decide whether the next phase starts by itself and whether the browser raises a notification at the end of a phase.

A focus session counts only when it runs to the end. It then adds one to today's completed total, appends an entry to the session history with the date, the finishing time and the minutes, and adds one to the linked task if there is one. Link a task from the select on the Task card, or arrive from the task manager's play button, which opens this page with that task already attached and its completed sessions shown against its estimate.

Your durations, today's count, your tasks and the session log are kept in this browser's local storage. Nothing is uploaded, so the figures do not follow you to another device, and clearing site data for this site removes them. The log holds the most recent 2000 sessions and the card lists the last six; the longer view lives in the focus statistics page.

Say you press 50/10 and link a task you have estimated at six sessions. The first focus phase runs 50 minutes, the chime sounds, and a 10 minute short break follows. Three more focus phases go the same way, except that the fourth is followed by the long break the preset carries, which is 20 minutes rather than 10. Four focus phases, three short breaks and one long break come to 250 minutes of wall clock for 200 minutes of focus.

During that long break Completed reads 4, Cycle reads 4 of 4, all four dots under the ring are filled, and the pill above it reads 4/6 against the task. Session history shows four lines, each with the date, the clock time the phase ended and 50 min beside it. The moment the long break ends a fresh cycle begins: the dots empty and Cycle counts from one again with the fifth focus phase, while Completed carries on climbing.

Nothing stops at 6/6. An estimate is only there to compare against, so a task that needs nine sessions shows 9/6 and keeps going. Reading those two numbers against each other after a few weeks costs nothing and is the cheapest correction there is to how you estimate.

Reset is the harmless one. It stops the phase, puts the full length back on the ring and writes nothing at all: no line in the history, no increment on the linked task, no movement in the cycle dots. It is what you want when you started the wrong phase.

Skip is not the same thing. It records no session either, but a skipped focus phase still counts towards the four, so the dots advance and a long break can arrive off the back of work you did not do. That is intended, because Skip exists mainly to get past a break you do not want, and it is the reason Completed and Cycle can disagree on the same screen.

Pause holds the time that was left rather than the end it was heading for, so a phase paused with 18 minutes on the ring still has 18 minutes when you come back an hour later. One edge is worth knowing about: the length written into the history is the focus length in the field when the phase ends, not the one it began with. Drop the focus field from 50 to 25 while a 50 minute phase is running and the ring keeps its 50 minutes, but the log entry says 25. Edit the durations between phases and the two never disagree.