pomo

README

Pomo

Simple pomodoro timer CLI.

Inspired by rwxrob/pomo, but written from scratch because why not!

Installation

go install github.com/mskelton/pomo@latest

Usage

Get status

Prints the status of the current session.

pomo

Start focus

Starts a new pomodoro focus session with the default duration.

pomo start

Or customize the session duration by providing a Go Duration.

pomo start 15m

Start break

Starts a new break with the default duration.

pomo break

Or customize the break duration by providing a Go Duration.

pomo break 10m

Change duration

Changes the duration of the active session using the specified Go Duration.

pomo duration 20m

Stop session

Stops the current pomodoro session.

pomo stop

Config

The default values for all commands can be customized by creating a $HOME/.config/pomo/config.json file. Below is an example of all available configuration options with their default values.

{
  "durations": {
    "break": "5m",
    "focus": "30m"
  },
  "emojis": {
    "break": "🥂",
    "focus": "🍅",
    "warn": ["🔴", "⭕"]
  },
  "sound": "default"
}