Rust Pomodoro 🦀🍅

A simple and configurable Pomodoro timer built in Rust. Use it to stay focused, manage breaks, and track your work sessions—all from the command line.

Features

• Start a Pomodoro session with custom focus/break times and rounds
• Persist your preferred settings between runs
• Update settings independently (focus time, break time, rounds)
• Reset all settings to default

Installation

Clone the repository and build the project using Cargo:

git clone https://github.com/yourusername/pomodoro-cli.git
cd pomodoro-cli
cargo build --release

Then you can run the binary:

./target/release/pomodoro

Usage

pomodoro <COMMAND>

Commands

start

Start a Pomodoro session. You can optionally override settings with flags.

pomodoro start [--focus <minutes>] [--break <minutes>] [--rounds <count>]

• --focus: Duration of the focus session in minutes
• --break: Duration of the break session in minutes
• --rounds: Number of focus/break rounds

focus

Update the default focus session time.

pomodoro focus <minutes>

break

Update the default break session time.

pomodoro break <minutes>

rounds

Update the default number of rounds.

pomodoro rounds <count>

reset

Reset all saved settings to defaults.

pomodoro reset

Configuration

User preferences are saved between runs. The configuration is read from and written to a file automatically (typically in a JSON or similar format—see the config module).

If you provide any values via command-line flags during a start, they will override the saved config temporarily for that session.

Example

# Start a 25/5 pomodoro session with 4 rounds
pomodoro start --focus 25 --break 5 --rounds 4

# Set focus time to 30 minutes
pomodoro focus 30

# Reset all saved preferences
pomodoro reset

License

MIT

---

Built with ❤️ in Rust.