Skip to content

Latest commit

 

History

History
58 lines (39 loc) · 1.58 KB

README.md

File metadata and controls

58 lines (39 loc) · 1.58 KB

Flow Pomodoro

A minimal Pomodoro timer for macOS. Built with Swift and SwiftUI.

Inspired by Flow -- I wanted the same core experience without the subscription and the bloat. The result is a ~1.5 MB app (vs ~70 MB for the original) that does everything I need: work sessions, breaks, configurable durations, saved setups, and keyboard-driven control.

The entire app was written by Claude Code (Opus 4.5) with minimal manual intervention.

How it does look like

Main Window

Work session    Break

Menu Bar

Work menu    Break menu

Settings

Session settings    App settings

Features

  • Menu bar timer (left-click: show window, right-click: start/pause)
  • Work sessions, short breaks, long breaks
  • Configurable durations with saved setups
  • Keyboard shortcuts: Space (play/pause), Cmd+R (reset), Cmd+→ (skip), Cmd+, (settings)

Install

Download the latest DMG from Releases, open it, and drag Flow2 to Applications.

First launch: Right-click the app → Open → Click "Open" in the dialog (required once for unsigned apps).

Build from source

Requires Xcode.

git clone https://github.com/fserr/flow.git
cd flow
open Flow.xcodeproj
# Cmd+R to build and run