🍅 Pomodoro CLI

Pomodoro is a command-line interface to run timers from your terminal for people using the Pomodoro Technique.

I started this project in 2017, as a pet project to learn how to write a CLI in Swift. I never stopped writing CLI tools from then.

Usage

➜ Usage: pomodoro-cli [options]

CLI pomodoro

Options:
  -d, --duration <value>    The duration of the pomodoro in seconds (100) or in minutes (10m) (default to 25m)
  -h, --help                Show help information
  -m, --message <value>     The intent of the pomodoro (example: email zero)

Hooks

Pomodoro can optionnaly run shell scripts when a pomodoro starts and/or finishes.

Sample scripts can be found in the SampleHooks directory.

Journal

A journal of pomodoros is created in ~/.pomodoro-cli/journal.yml.

Installation

From Source

To install from sources, Swift is required.

Installing swiftlint and swiftformat via Homebrew, and having installed Ruby/Bundler are recommended for an easy installation.

• make install will install development dependencies;
• make deploy will build a release binary, move it to /usr/local/bin by default, with default hooks installed;

Check out Makefile for more development convenience commands.

From Distribution Images

The .dmg files are created via:

make clean notarize
# and upon successful feedback from the Apple notary service:
make image

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT