Pomodoro

Pomodoro

The Pomodoro Technique for focused work sessions.

---

Overview

The Pomodoro Technique helps maintain focus through timed work sessions:

1. Work phase: 25 minutes of focused work
2. Short break: 5 minutes rest
3. Repeat: After 4 cycles, take a long break (15 minutes)

---

Starting a Session

1. Select a task (optional)
2. Press F5 to start
3. The timer appears in the header/footer

---

Timer Display

🍅 23:45 [2/4]

Part	Meaning
🍅	Work phase
☕	Short break
🌴	Long break
23:45	Time remaining
[2/4]	Cycles completed / goal

---

Controls

Key	Action
F5	Start session
F6	Pause / Resume
F7	Skip current phase
F8	Stop session
+	Increase cycle goal
-	Decrease cycle goal

---

Session Lifecycle

Start → Work (25m) → Short Break (5m) → Work → ... → Long Break (15m)
         ↑                                              |
         └──────────────────────────────────────────────┘

The session cycles through phases automatically:

1. Complete work phase → Short break starts
2. Complete short break → Next work phase starts
3. After N work phases (default: 4) → Long break
4. After long break → Cycle resets

---

Phase Transitions

Current Phase	Next Phase	Condition
Work	Short Break	cycles < cycles_before_long_break
Work	Long Break	cycles >= cycles_before_long_break
Short Break	Work	Always
Long Break	Work	Resets cycle counter

---

Phases

Work Phase (🍅)

• Default: 25 minutes
• Focus on your task
• Timer counts down

Short Break (☕)

• Default: 5 minutes
• Rest your eyes and mind
• Occurs after each work phase

Long Break (🌴)

• Default: 15 minutes
• Longer rest period
• Occurs after completing cycle goal (default: 4)

---

Pausing

Press F6 to pause. The display shows:

🍅 ⏸ 23:45 [2/4]

Press F6 again to resume.

---

Skipping

Press F7 to skip to the next phase:

• During work → Start break
• During break → Start next work phase

---

Stopping

Press F8 to stop the session completely.

---

Configuration

Customize timings in ~/.config/taskflow/config.toml:

[pomodoro]
work_minutes = 25
short_break_minutes = 5
long_break_minutes = 15
cycles_before_long_break = 4

---

Pomodoro Statistics

The Reports view shows:

• Total cycles completed
• Total work time
• Cycles per date
• Current streak
• Longest streak

---

Tips

1. Start with a task selected - Helps focus
2. Honor the breaks - They're part of the technique
3. Adjust cycle goal - Use +/- based on your energy
4. Combine with time tracking - Press t before starting

---

Typical Session

1. Select task you want to work on
2. Press t to start time tracking
3. Press F5 to start Pomodoro
4. Work until 🍅 timer ends
5. Take short break (☕)
6. Repeat 4 times
7. Take long break (🌴)
8. Press F8 when done

---

Keybindings

Key	Action
F5	Start Pomodoro
F6	Pause / Resume
F7	Skip phase
F8	Stop Pomodoro
+	Increase goal
-	Decrease goal

---

See Also

• Time-Tracking - General time tracking
• Focus-Mode - Distraction-free view
• Configuration - Customize timings
• Reports - Pomodoro statistics