Skip to main content

​
Work session

Work sessions are the focused work periods in your Pomodoro cycle.
​
work.duration
duration
default:"25m"
Length of work sessionsSupports duration formats: 25m, 1h30m, 90s
​
work.title
string
default:"work session"
Display title for work sessionsShown in the terminal UI during the session

​
Example

pomo.yaml
work:
  duration: 25m
  title: work session

​
Break session

Short breaks between work sessions for quick rest.
​
break.duration
duration
default:"5m"
Length of break sessionsSupports duration formats: 5m, 10m, 300s
​
break.title
string
default:"break session"
Display title for break sessionsShown in the terminal UI during the session

​
Example

pomo.yaml
break:
  duration: 5m
  title: break session

​
Long break

Longer breaks after completing multiple work sessions.
​
longBreak.enabled
boolean
default:"true"
Enable long breaks after a set number of work sessions
​
longBreak.after
integer
default:"4"
Number of work sessions before triggering a long breakMust be greater than 0. Defaults to 4 if invalid.
​
longBreak.duration
duration
default:"15m"
Length of long break sessionsTypically longer than regular breaks for extended rest

​
Example

pomo.yaml
longBreak:
  enabled: true
  after: 4      # Long break after 4 work sessions
  duration: 15m
Long breaks are automatically inserted after the configured number of work sessions. If you complete 4 work sessions, the next break will be a long break instead of a regular break.

​
Duration format

Pomo accepts flexible duration formats: 
duration: 25m
duration: 5m

duration: 1h30m
duration: 2h

duration: 90s
duration: 300s

duration: 1h25m30s

​
Common configurations

work:
  duration: 25m
  title: work session

break:
  duration: 5m
  title: break session

longBreak:
  enabled: true
  after: 4
  duration: 15m
The classic Pomodoro Technique uses 25-minute work sessions with 5-minute breaks, and a longer 15-minute break after 4 sessions. Experiment with different durations to find what works best for you.

​
Overriding via CLI

You can override session durations from the command line:
Terminal
pomo              # Use config defaults
pomo 30m          # 30-minute work session
pomo 45m 15m      # 45-minute work with 15-minute break
pomo break 10m    # 10-minute break session
CLI arguments override config file settings for that session only. Your pomo.yaml file remains unchanged.

Build docs developers (and LLMs) love

Get started for freeTalk to us