github.com

Privacy-first screen break reminder app with local-only data storage

Knook screenshot showing the app interface

Knook is a native SwiftUI menu bar app that provides screen break reminders on macOS without requiring accounts, subscriptions, or cloud syncing. The app tracks break schedules locally and offers both short and long break intervals with context-aware pause behavior.

The scheduler supports heads-up reminder panels before break periods begin, followed by full-screen break overlay windows when it’s time to step away. Users can postpone breaks, skip them entirely, end breaks early, or manually pause and resume the reminder system. The app includes office hours configuration to limit reminders to working periods, idle reset functionality to adjust timing based on computer activity, and smart pause detection for full-screen focus modes.

Settings are stored locally in versioned JSON format within macOS Application Support directories. The app does not transmit data to external servers or require network connectivity to function. Launch-at-login support ensures the reminder system remains active across system restarts.

Knook is distributed as open-source software under the MIT License and can be installed via direct download from GitHub releases or through Homebrew. The project remains in active development with ongoing work on keyboard accessibility, timing algorithm refinements, and contributor workflow improvements.

Limitations include alpha-stage stability, pending notarization for streamlined distribution, and incomplete support for advanced smart pause providers such as meeting detection and video context awareness. Future roadmap items include AppleScript integration, Shortcuts support, and Focus Filters compatibility.

The app is suitable for users who need straightforward break reminders with full transparency into data handling and prefer local-first software without subscription models. It requires macOS 13 or newer and is particularly relevant for remote workers, developers, and individuals prioritizing screen time management with privacy guarantees.

FAQ

What does Knook do?+

Knook is a SwiftUI menu bar break reminder. It schedules short and long breaks with heads-up panels before each, full-screen overlays during breaks, and controls to postpone, skip, end early, or pause the system entirely.

Is Knook free?+

Yes. Knook is free and open-source under the MIT license, with the source code on GitHub at github.com/preetsuthar17/nook.

How do I install Knook on macOS?+

Download the latest release from https://github.com/preetsuthar17/nook (look for the .dmg or .zip under Releases) or install via Homebrew.

Does Knook run on Apple Silicon?+

Yes. Knook runs on Apple Silicon (M1, M2, M3, M4) and Intel Macs and requires macOS 13 or newer.

Where does Knook store its settings?+

Knook stores settings locally as versioned JSON in the macOS Application Support directory. There are no accounts, subscriptions, or cloud sync, and the app does not require network connectivity.

How does Knook handle smart pause?+

Knook supports office hours configuration, idle reset to adjust timing based on computer activity, and smart pause for full-screen focus modes. Advanced smart pause providers like meeting detection and video context awareness are still on the roadmap.

Related Apps