Skip to main content

​
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

​
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: If you enter an invalid choice, the timer defaults to 60 minutes.

​
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

​
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:

​
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: