pomodoro — run a focus (Pomodoro) timer
SYNOPSIS
pomodoro [minutes] [break-minutes] pomodoro status | stop
DESCRIPTION
Starts a work timer (25 minutes by default) that runs in the background, so the terminal stays usable. A live progress line shows the time left, and the browser tab title counts down too.
When the time is up, a chime plays (Web Audio API) and every shell window flashes. If a break length is given, a break timer then starts automatically and rings at its end.
Only one timer runs at a time, shared by every shell window.
OPTIONS
status show the running timer stop cancel the running timer
THE TECHNIQUE
The Pomodoro Technique, created by Francesco Cirillo, splits work into focused intervals — traditionally 25 minutes — separated by short breaks of about 5 minutes; after four intervals, take a longer break. Short, timed sprints make it easier to start a task, to avoid distractions and to notice where the time goes.
USE CASES
- pomodoro 25 5 for the classic cycle, pomodoro 50 10 for deep work;
- a quick reminder: pomodoro 0.5 rings in 30 seconds;
- keep using the terminal meanwhile: the timer runs in the background, and the browser tab title shows the time left.
EXAMPLES
pomodoro pomodoro 50 10 pomodoro 0.5 pomodoro stop