A beautiful floating flow timer for deep work sessions
A native macOS floating widget that counts up toward an estimated duration. No hard stops - the timer keeps running into overtime. A tibetan singing bowl rings at the halfway point and when estimated time is reached. The living gradient background shifts from purple to orange (halfway) to red (overtime) to gray (paused).
git clone https://github.com/ronilaukkarinen/focus-timer.git
cd focus-timer
swift build -c release
cp .build/release/focus-timer /opt/homebrew/bin/focus-timerfocus-timer --name "Deep work: KM-108 TTS" --time 45| Argument | Default | Description |
|---|---|---|
--name |
Focus |
Task name displayed in the widget |
--time |
25 |
Estimated duration in minutes |
| Key | Action |
|---|---|
| Space | Pause / Resume |
| Enter | Complete and close |
| State | Background | Trigger |
|---|---|---|
| Normal | Purple | 0-49% |
| Halfway | Orange | 50-99% + bell |
| Overtime | Red | 100%+ bell |
| Paused | Gray | Space key |
Designed to be launched by Claude Code during daily planning. Add to your planner command:
When scheduling deep work blocks, launch the focus timer in the background:
focus-timer --name "Task name" --time <minutes> &
- macOS 13 or later