TouchGrass

Product Introduction

1. Definition: TouchGrass is a native macOS application (macOS 14+) that functions as an intelligent, context-aware break reminder and digital wellness tool. It operates as a local daemon/service, leveraging macOS system APIs to monitor user activity and device state without requiring Accessibility permissions.
2. Core Value Proposition: TouchGrass exists to solve the problem of disruptive and poorly timed break reminders by intelligently pausing its countdown during meetings, calls, media playback, and screen recordings. Its core value is delivering non-intrusive, privacy-respecting wellness prompts that adapt to your actual workflow, not just a timer.

Main Features

1. Context-Aware Break Scheduling: The app's primary feature is its ability to detect user context and postpone break reminders. It works by monitoring system-level audio sessions to detect active calls or meetings (e.g., Zoom, Teams, Discord) and observing media playback states (e.g., YouTube, Spotify, QuickTime Player). When these activities are detected, the break timer automatically pauses and resumes only during natural work pauses.
2. Automatic Break Recognition (Time Away Detection): TouchGrass counts time when your Mac is idle or asleep as a completed break. Using macOS sleep/wake and user idle APIs, it detects periods of absence (e.g., stepping away for coffee, lunch) and intelligently adjusts the next scheduled break interval, preventing redundant reminders immediately after you return.
3. Comprehensive Wellness Reminders Suite: Beyond standard break prompts, TouchGrass includes three specialized, activity-based reminders:
   • Blink Reminders: Triggered when prolonged screen focus is detected, aiming to combat reduced blink rate and digital eye strain.
   • Posture Nudges: Activated based on continuous active work time at the computer, encouraging postural changes.
   • Typing Strain Alerts: Uses activity monitoring to suggest rest after sustained typing sessions, targeting repetitive strain injury (RSI) prevention.
4. Privacy-First, Local-Only Architecture: All processing occurs locally on the user's Mac. The app explicitly does not require Accessibility permissions, meaning it cannot read screen content, log keystrokes, or monitor specific inputs. Internet access is strictly limited to initial license validation and periodic update checks; no analytics, tracking, cloud sync, or user accounts are involved.

Problems Solved

1. Pain Point: Traditional break timer apps disrupt deep work flow by triggering alarms during important meetings, client calls, or media consumption, making them easy to ignore or disable.
2. Pain Point: Most digital wellness tools require extensive system permissions (Accessibility) to function, raising valid privacy and security concerns for users.
3. Target Audience: The primary user personas are knowledge workers, remote professionals, developers, writers, and students who spend extended hours on macOS and value both productivity and ergonomic health without sacrificing privacy.
4. Use Cases: Essential for professionals in back-to-back video conferences who need reminders but cannot be interrupted mid-call. Critical for developers in long coding sessions who need posture and blink reminders. Ideal for privacy-conscious users who want wellness features but distrust apps requiring broad system access.

Unique Advantages

1. Differentiation: Unlike standard break timers (e.g., Time Out, Stretchly) that are purely time-based, TouchGrass adds a critical layer of contextual intelligence. Unlike more invasive wellness suites, it delivers core functionality without Accessibility permissions, offering a superior privacy stance.
2. Key Innovation: The technical approach of using macOS audio session and media playback APIs for context detection, combined with idle/sleep state monitoring for break validation, creates a truly adaptive system. This allows it to respect user workflow authentically, a significant innovation over brute-force timing.

Frequently Asked Questions (FAQ)

1. How does TouchGrass detect meetings without Accessibility permission? TouchGrass uses macOS Core Audio APIs to check for active audio input/output sessions. When an app like Zoom or Google Meet is using the microphone or speaker for communication, the system registers an active audio session, which TouchGrass detects locally. It does not access the microphone audio stream itself.
2. Is TouchGrass completely private and offline? All core functionality—context detection, timing, reminders—runs 100% locally on your Mac and works offline. An internet connection is only required for two actions: initial license validation after the 7-day trial and checking for software updates. No personal data, activity logs, or analytics are ever transmitted.
3. What macOS versions are supported and is it on the App Store? TouchGrass requires macOS 14 (Sonoma) or later. It is currently available as a direct download (.dmg) from the developer's website. A version on the Mac App Store is announced as "coming soon," which may involve a separate build due to Apple's sandboxing restrictions.
4. How does the one-time purchase license work? After the 7-day free trial, a one-time payment of $3.99 grants a perpetual license for the current major version. The developer promises "lifetime updates," which typically means free updates and bug fixes for the foreseeable future, distinct from a subscription model.
5. Can I customize the break reminders and screens? Yes, TouchGrass offers extensive customization. Users can modify break screen visuals and wallpapers, reminder messages, timing intervals, break durations, working hours, and the enforcement level of the reminders (from gentle notifications to strict, unskippable breaks).