adrafinil

rx no. 006 ・ a·draf·i·nil /əˈdræfɪnɪl/ ・ a eugeroic for machines

A signed, notarized disk image · free and open source (MIT)

awake ・ an agent is working idle ・ no agents, normal sleep hold ・ keep it awake yourself — 15m to ∞

服用注意 ・ for machines that keep watch after you've gone to sleep.

It's 3 a.m. You're asleep. The agent isn't — it's still mid-thought in a session you started hours ago, and you've closed the lid over it like an eyelid that won't quite shut. caffeinate and Amphetamine are stimulants: they keep the machine wired forever, whether or not anyone's home. Adrafinil is the eugeroic. It does nothing until an agent acquires it, keeps your Mac awake through a closed lid only for as long as that work lives, and clears the moment the last session releases. It only ever wakes for the work — then you both sleep.

Keep your Mac awake only while AI agents are working.

Adrafinil is a macOS menu bar app that prevents the system from sleeping — including clamshell (lid-closed) sleep — exclusively while an AI coding agent has an active session. When no agent is working, sleep behavior is untouched: close the lid and the Mac sleeps normally.

It's the opposite of always-on wake utilities like caffeinate or Amphetamine. Adrafinil only intervenes when an agent (Claude Code, Codex, Cursor, …) is mid-task, and gets out of the way the moment that work finishes.

Three ways it stays awake:

• Automatically — agent hooks tell Adrafinil when a turn starts and ends, so it holds sleep only while an agent is actually working. (Optional process-sniffing can also spot a running agent that has no hooks installed.)
• Agent-driven — an agent can deliberately keep the Mac awake past its reply for a long build or deploy, via the bundled MCP tool or the adrafinil hold CLI.
• Manually — a menu-bar Keep awake button places a time-boxed hold yourself, even with no agents running; Let it sleep clears everything.

Privileged sleep control. Overriding clamshell sleep requires root. Adrafinil isolates that in a tiny, audited helper that only exposes setSleepBlocked(Bool) — all policy lives in an unprivileged daemon. It holds a standard IOPMAssertion for idle sleep and uses pmset disablesleep for clamshell (lid-closed) sleep, after verifying on-device that the cleaner private paths don't keep a displayless lid-closed Mac awake. See [Docs/ARCHITECTURE.md](Docs/ARCHITECTURE.md) §2.