GitHub - ykushch/notchagent
Contribute to ykushch/notchagent development by creating an account on GitHub.
macOS Utility
Summary
Adrafinil is a Mac utility that keeps the system awake only during active AI coding sessions, preventing sleep during lid-closed work. It dynamically manages assertions to ensure normal sleep behavior when agents are idle, offering a targeted alternative to always-on wake tools.
Highlights
- Agent-aware sleep management blocks sleep only when AI agents are active.
- Supports clamshell mode to prevent lid-closed sleep during coding tasks.
- Uses isolated privileged helpers for secure sleep control.
- Includes thermal cutouts to prevent overheating with closed lids.
- Integrates with nine major AI coding agents via one-click install.
auto-generated
Context
Audience
Developers using AI coding assistants
DomainSoftware Development
Formatopen source software
Accessopen source
Source Overview
Adrafinil is a macOS menu bar app that blocks idle and clamshell sleep only while AI coding agents (Claude Code, Codex, Cursor, and 6 others) hold active assertions, releasing the moment all sessions end.
A root-level helper manages sleep-blocking APIs while an unprivileged daemon handles reference counting, process monitoring, and thermal cutoff. Requires macOS 26.4+ and admin rights for the privileged helper.
Topics
Related
macOSAI Coding AgentsClaude CodeCursorAmphetamineCaffeinate
