Support

We're here to help you get the most out of SleepSleuth.

Frequently Asked Questions

What does SleepSleuth do?

SleepSleuth is a macOS menu bar utility that monitors power assertions — system-level flags that prevent your Mac from sleeping. It shows you which apps and processes are keeping your Mac awake, lets you pin selected apps or command-line tools on purpose, and can optionally show local AI coding token usage.

What macOS version do I need?

SleepSleuth requires macOS 14 (Sonoma) or later.

Does SleepSleuth collect any data?

No. SleepSleuth operates entirely on your device. It does not send any data over the network, and includes no analytics or tracking. Optional token usage data is read from local files you authorize. See our Privacy Policy for details.

Why is my Mac not sleeping?

Open SleepSleuth from the menu bar to see a list of all active power assertions. Each entry shows the process name, the reason it gave for preventing sleep, and how long the assertion has been active. Common culprits include video players, backup utilities, and file sync apps.

Can I stop a process from preventing sleep?

For processes you own (non-system), SleepSleuth provides a copyable kill command and a button to open Terminal so you can terminate the process. System processes are shown for informational purposes only.

Where is history data stored?

Assertion history is stored locally at ~/Library/Application Support/SleepSleuth/history.json. It is automatically pruned to a 7-day rolling window. You can clear all history from the History view within the app.

How does Agent Token Usage work?

The Agent Token Usage card reads local usage files from tools you configure, such as Claude Code, OpenCode, Codex, OpenClaw, GitHub Copilot CLI, Amp, Codebuff, Droid, Gemini CLI, Goose, Hermes, Kilo Code, Kimi, Pi, and Qwen Code. You can authorize your home folder for automatic discovery or add individual sources manually.

Where is token usage data stored?

Configured sources, cached daily aggregates, and security-scoped bookmarks are stored in app preferences. Estimated cost entries are cached locally at ~/Library/Application Support/SleepSleuth/cost-cache.json so historical totals stay stable. Remove configured sources or delete the SleepSleuth Application Support folder to clear local files.

How do I uninstall SleepSleuth?

Drag the app to the Trash. To remove stored data as well, delete the folder at ~/Library/Application Support/SleepSleuth/.

Contact Us

If your question isn't answered above, email us at support@sleepsleuth.app.