Skip to content

Wellness mode - Session duration and break remindersย #219

@rz1989s

Description

@rz1989s

Parent Epic

#191

Description

Add developer wellness features that remind users to take breaks, track session duration, and promote healthy coding habits.

The Problem

  • 83% of developers experience burnout
  • Long uninterrupted sessions reduce productivity
  • Context switching takes 23 minutes to recover
  • No dev tools address wellness

Features

1. Session Duration Tracking

Session: 2h 15m ๐ŸŸก โ”‚ Break recommended in 15m

2. Break Reminders

โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
โ”‚ ๐Ÿง˜ BREAK REMINDER โ”‚ You've been coding for 2 hours          โ”‚
โ”‚    Consider a 10-minute break to maintain productivity       โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ

3. Pomodoro Integration

./statusline.sh --pomodoro         # Start pomodoro timer
./statusline.sh --pomodoro --work 25 --break 5

Session: Pomodoro 2/4 โ”‚ ๐Ÿ… Focus (18:32 remaining)

4. Daily Stats

./statusline.sh --wellness

โ•ญโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฎ
โ”‚                   Wellness Report                             โ”‚
โ”‚                   January 22, 2026                            โ”‚
โ•ฐโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ•ฏ

Total Coding Time:    4h 30m
Longest Session:      2h 15m โš ๏ธ (recommend < 90min)
Breaks Taken:         3
Average Session:      1h 30m

Focus Quality:        โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘ 80%
Break Compliance:     โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–‘โ–‘โ–‘โ–‘ 60%

Recommendation: Try shorter sessions with more frequent breaks

Configuration

[wellness]
enabled = true
session_warning_minutes = 90     # Warn after X minutes
break_reminder_minutes = 120     # Remind after X minutes
pomodoro_work_minutes = 25
pomodoro_break_minutes = 5
terminal_bell_on_break = true

Integration with Islamic Mode

When both are enabled:

๐Ÿ•Œ Dhuhr in 45m โ”‚ ๐Ÿง˜ Break in 30m โ”‚ Suggestion: Work 30m, break at Dhuhr

Why This Matters

  • Reduces developer burnout
  • Improves long-term productivity
  • Shows we care about users
  • Unique feature in the ecosystem

Acceptance Criteria

  • Session duration tracking
  • Break reminder system
  • Pomodoro timer mode
  • Wellness report command
  • Integration with Islamic mode
  • Configurable thresholds
  • Tests added

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or requestmoatUnique differentiating featurepriority:mediumMedium priority itemwellnessDeveloper wellness features

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions