Privacy Policy

Last updated: May 26, 2026

Overview

SleepSleuth ("the App") is a macOS menu bar utility that monitors power assertions on your Mac and can optionally read local coding-agent token usage files that you authorize. Your privacy is important to us. This policy explains what data the App accesses, how it is used, and your choices.

Data We Collect

We do not collect, transmit, or store any personal data on external servers. SleepSleuth operates entirely on your device.

Data Accessed Locally

To function, the App reads the following information from your Mac:

• Power assertion data — The App uses Apple’s IOPMLib API to query which processes currently hold power assertions (e.g., preventing sleep). This includes process names, process IDs, assertion types, and reasons.
• Process metadata — For each process holding an assertion, the App may resolve the application name, bundle identifier, and icon from the local file system.
• Assertion history — The App stores a rolling 7-day history of assertion events as a JSON file in your local Application Support directory (~/Library/Application Support/SleepSleuth/). This file never leaves your device.
• Optional token usage files — If you enable Agent Token Usage, the App reads local usage logs or databases from configured coding tools, such as Claude Code, OpenCode, Codex, OpenClaw, GitHub Copilot CLI, Amp, Codebuff, Droid, Gemini CLI, Goose, Hermes, Kilo Code, Kimi, Pi, and Qwen Code.
• Security-scoped bookmarks — When you authorize a folder or file for token usage, the App stores a macOS security-scoped bookmark so it can continue reading the selected local source.
• Token usage aggregates and cost cache — The App stores configured token usage sources and cached daily aggregates in app preferences. Estimated cost entries are cached locally in the SleepSleuth Application Support folder so historical cost calculations remain stable.

Data Sharing

SleepSleuth does not:

• Send any data over the network
• Include analytics or tracking frameworks
• Communicate with any external servers
• Use cookies or web-based tracking

Notifications

If you enable notifications, the App uses Apple’s local notification system (UNUserNotificationCenter) to alert you when new power assertions are detected. These notifications are generated and delivered entirely on your device.

Third-Party Services

SleepSleuth does not integrate with any third-party services, SDKs, or analytics platforms.

Data Retention

Assertion history is automatically pruned to a 7-day rolling window. Token usage source settings and cached aggregates remain local until you remove sources, clear caches from settings where available, reset app preferences, or uninstall the App. Uninstalling the App and deleting the Application Support folder removes locally stored SleepSleuth files.

Children’s Privacy

SleepSleuth does not collect any personal information from anyone, including children under the age of 13.

Changes to This Policy

We may update this Privacy Policy from time to time. Any changes will be reflected on this page with an updated "Last updated" date.

Contact

If you have questions about this Privacy Policy, please email us at support@sleepsleuth.app.