Breaks

Product Introduction

1. Definition: Breaks is a native macOS productivity utility designed as a lightweight, open-source Pomodoro timer and focus journal. Built specifically for the macOS ecosystem (version 13 or later), it functions as a sandboxed menu bar application that tracks work intervals while providing a structured feedback loop for task management.

2. Core Value Proposition: Breaks exists to provide a "noise-free" productivity environment for users who require the Pomodoro technique without the privacy trade-offs of modern SaaS tools. By eliminating accounts, analytics, and cloud dependencies, it prioritizes user attention and data sovereignty. Key value drivers include its seamless menu bar integration, "honest" streak tracking that accounts for real-life interruptions, and native performance via a universal binary.

Main Features

1. Integrated Menu Bar Interface: Unlike traditional applications that occupy Dock space or require active window management, Breaks resides exclusively in the macOS menu bar. It utilizes a popover UI for configuration and session management, offering a "corner of the eye" countdown that minimizes cognitive load. This architectural choice ensures the tool remains accessible via global system layers without interrupting the user's primary workspace.

2. Focused Journaling & Session Grading: Beyond a simple countdown, Breaks implements a qualitative tracking system. Users can label focus blocks and categorize the quality of their work as "good," "messy," or "skipped." This data is aggregated into a weekly review heatmap, allowing for high-level analysis of peak productivity periods and time allocation patterns.

3. Calendar Export Engine (v1.1): This feature enables the automated writing of completed focus sessions to the macOS Calendar. By leveraging native permissions, it exports the session label, start time, and end time, effectively transforming a focus timer into a passive time-tracking and billing log for professionals who need to document their workday.

4. Honest Streak Logic & Idle Detection: Breaks employs a sophisticated reconciliation algorithm for streaks and timers. It monitors system sleep/wake notifications to prevent timer drift and uses a configurable "idle threshold" to detect when a user has walked away from their machine. To prevent "streak burnout," it introduces a weekly pause-day budget (based on ISO weeks), allowing users to maintain progress during rest days or unexpected interruptions.

5. Global Carbon Hotkeys: For power users, the application implements system-wide global hotkeys. Utilizing Carbon hotkeys, users can start, pause, skip, or reset timers from any active application. This ensures that the Pomodoro workflow remains friction-less, even during intensive coding or design sessions where switching windows would break "flow state."

Problems Solved

1. Subscription and Notification Fatigue: Most modern productivity apps use "freemium" models, requiring accounts and sending intrusive notifications. Breaks addresses this by being entirely free, MIT-licensed, and local-first, removing the "shouting" nature of traditional reminders.

2. Target Audience:

• Software Developers: Who require deep work sessions and prefer native, lightweight tools that don't consume significant RAM (unlike Electron-based alternatives).
• Privacy-Conscious Professionals: Who cannot use cloud-based trackers due to corporate security policies or personal data preferences.
• Remote Workers & Freelancers: Who need an objective record of their focus time for self-reflection or client reporting.
• Students: Looking for a simple, non-punishing way to build study habits using the Pomodoro method.

3. Use Cases:

• Deep Work Documentation: Using the Calendar export to visualize how many 25-minute "deep work" blocks were actually achieved in a day.
• Health and Movement Breaks: Utilizing custom break suggestions to nudge users toward physical movement or eye rest.
• Habit Formation: Using the heatmap and streak budget to build long-term consistency without the psychological penalty of a single missed day.

Unique Advantages

1. Differentiation: Breaks distinguishes itself from competitors through its "Zero-Knowledge" architecture. While most timers utilize third-party analytics (like Firebase or Mixpanel), Breaks stores all state locally in macOS UserDefaults. It is a universal binary, meaning it is optimized for both Intel-based Macs and Apple Silicon (M1/M2/M3 chips) natively.

2. Key Innovation: The "Pause-Day Budget" is a unique psychological approach to streaks. Unlike standard apps that reset a streak to zero upon one missed day, Breaks treats productivity as a long-term rhythm. By absorbing a configurable number of missed days per week, it encourages sustainable progress rather than perfectionism.

Frequently Asked Questions (FAQ)

1. Is Breaks a safe, private Pomodoro app for Mac? Yes. Breaks is fully sandboxed and open-source under the MIT license. It requires no account, tracks no analytics, and does not transmit any data off your machine. All session data and settings are stored locally within the macOS UserDefaults system under the application's bundle ID.

2. Why does macOS show an 'unidentified developer' warning when installing Breaks? Breaks is currently a free side project and is not yet notarized via the $99/year Apple Developer program. To install it, you simply need to right-click the app and select "Open" on the first launch, or run the command xattr -dr com.apple.quarantine /Applications/Breaks.app in your Terminal to remove the macOS quarantine flag.

3. How does the timer handle my Mac going to sleep? Breaks is designed to be resilient to system state changes. It monitors sleep and wake notifications and reconciles the timer against an absolute end-date. If you close your laptop mid-session and open it an hour later, the app will correctly identify that the session has concluded or adjust the remaining time accordingly, preventing timer drift.

4. Can I export my focus sessions to my Google or iCloud Calendar? Yes. Starting in version 1.1, you can enable Calendar export in the settings. Once you grant the necessary macOS permissions, Breaks will automatically create entries in your chosen local or synced calendar (including iCloud or Google accounts synced to the macOS Calendar app) upon the completion of a focus block.