Documentation Index
Fetch the complete documentation index at: https://imsaikirann.in/llms.txt
Use this file to discover all available pages before exploring further.
Commands
This page lists every go-pomodoro command and what it does.
pomodoro
Show the welcome message.
Use this when you want to confirm the CLI is installed.
pomodoro start
Start a focus timer.
By default, this starts a 25 minute focus session.
Options
| Option | Short | Default | Description |
|---|
--minutes | -m | 25 | Focus duration in minutes. |
--deep | -d | false | Enable deep work mode. |
Examples
Start a default session:
Start a 45 minute session:
Start a 60 minute deep work session:
Limits
The --minutes value must be between 1 and 100.
pomodoro deep
Start an interactive deep work session.
The CLI asks you to choose:
| Choice | Duration | Use case |
|---|
1 | 45 minutes | Deep entry |
2 | 60 minutes | Standard deep work |
3 | 120 minutes | Full immersion |
pomodoro status
Show the current timer status.
If a timer is running, this prints the phase, remaining time, cycle count, breaks left, progress bar, and progress percentage.
If no timer is running, it prints:
Options
| Option | Short | Description |
|---|
--watch | -w | Keep the status view open and update it every second. |
Examples
Show status once:
Watch status live:
Exit watch mode with Ctrl+C.
pomodoro pause
Pause the current session.
Use this when you are interrupted and want to continue the same timer later.
pomodoro resume
Resume a paused session.
Use this after pomodoro pause.
pomodoro stop
Stop the running timer.
This stops the background timer process and resets the current timer state.
If no timer is running, it prints:
pomodoro sessions
Show recent sessions.
The command shows up to 10 recent sessions.
The table includes:
- Date and time.
- Duration.
- Type, such as normal or deep.
- Focus score.
pomodoro coach
Get productivity coaching from recent session history.
The command uses your recent sessions to build a short productivity summary.
If AI is configured with GROQ_API_KEY, it can return AI-generated advice. If coaching was generated recently, go-pomodoro can reuse cached advice for a short time.
If no sessions exist yet, it prints:
No sessions yet. Complete some focus sessions first.
pomodoro monitor
Start the activity monitor.
This starts a real-time sitting and activity monitor in the terminal.
pomodoro update
Update go-pomodoro to the latest released version.
This command only works for released builds. Development builds print an error because they do not know which released version they are.
pomodoro version
Print the installed version.
Example output:
Development builds may print: