go-pomodoro

A simple and lightweight Pomodoro timer CLI built with Go to help developers stay focused directly from the terminal. Designed to be minimal, fast, and distraction-free.

1. 01

   Start a focus session from the terminal with a default 25-minute timer.

2. 02

   Set a custom session length using -m or --minutes.

3. 03

   Run the timer in the background so the terminal stays free.

4. 04

   Check live status, including phase, time remaining, cycle count, breaks left, progress bar, and percentage.

5. 05

   Use watch mode with pomodoro status -w for continuously updating session progress.

6. 06

   Pause, resume, or stop a running focus session whenever needed.

7. 07

   Use deep work mode with pomodoro deep or pomodoro start -d.

8. 08

   Choose deep work presets for 45, 60, and 120 minute sessions.

9. 09

   Automatically calculate break length and cycle count based on focus duration.

10. 10

    Store session history locally in SQLite with date, time, duration, session type, and focus score.

11. 11

    Get break tips and productivity coaching from recent history, with optional GROQ_API_KEY AI support and fallback tips.

12. 12

    Includes desktop notifications, activity monitor, version command, self-update, npm and Go install support, plus Windows, Linux, and macOS binary releases.

Currently shipping with a public project page, production deployment, and documented source where available. The build captures the core workflow, tech stack, and product decisions behind the project.