Sugo 🍅

A minimal Pomodoro timer for macOS that lives in my menu bar. Sugo - traditional Italian tomato sauce flavored with olive oil, garlic, fresh basil and delicious tomatoes.

Installation

From Releases

1. Download the latest Sugo-x.x.x.dmg from Releases
2. Open the DMG file
3. Drag Sugo.app to your Applications folder
4. Launch Sugo from Applications or Spotlight

Troubleshooting: "Sugo.app is damaged and can't be opened"

If macOS shows this error, it's a Gatekeeper security warning for unsigned apps. To fix:

Important - Remove quarantine:

xattr -d com.apple.quarantine /Applications/Sugo.app

Build from Source

git clone https://github.com/nuromirg/sugo.git
cd sugo

make

# opens bundled
make run
# or put it to Applications/
make install

Configuration

The timer configuration is stored in ~/.sugo.json. You can edit it directly or use the "Edit Configuration..." menu option.

{
  "work_duration_minutes": 25,
  "short_break_duration_minutes": 5,
  "long_break_duration_minutes": 15,
  "sessions_until_long_break": 4,
  "advanced": {
    "afk_mode": "breaks_only",
    "afk_threshold_seconds": 300
  }
}

AFK Modes

• disabled: Never auto-pause
• breaks_only: Auto-pause only during breaks (not work sessions)
• always: Auto-pause during work and breaks