stop suffering.
let your agents keep working
while your mac lid is closed.
macos 14+ · signed · notarized
— OpenAI Developers (@OpenAIDevs) May 14, 2026
keeping mac awake
what happens otherwise
the lid clicks shut.
everything dies.
no caffeinate. no half-open lid. just a forgotten lid-close on battery. macos clamshell-sleeps the whole machine. the agent loses its socket. the model loses the turn. you come back to a dead terminal and 20 minutes of inference billed to nothing.
how it works
agent-aware, not just a coffee cup.
watches every claude code transcript
tails the jsonl session files at ~/.claude/projects. distinguishes an active turn from a session waiting for your reply.
watches your agent processes
polls the process list every 5 seconds against a user-editable allowlist. 40+ known cli agents preloaded.
holds the mac awake on ac power
uses iopmassertion preventsystemsleep. lid closes, machine stays alive, agent keeps thinking.
overrides on battery, optionally
one-time admin prompt installs a scoped sudoers entry, then caffeinagent toggles pmset disablesleep only while an agent is mid-run.
lets the mac sleep when done
the instant every agent goes idle or waits for your input, the assertion releases. battery saved.
detects
every agent you run.
curated from the skills.sh supported-agents list. add your own from the preferences pane in seconds.
one price
$5
once. lifetime updates. no subscription. fewer ceremonies than the lid-on-photocopier solution you currently have.
buy caffeinagentsigned · notarized · gatekeeper-clean
faq
questions.
does it really work with the lid closed on battery?
yes if you grant the one-time sudoers install. on apple silicon, the underlying pmset override doesn’t always survive on every chip; apple has been progressively tightening clamshell sleep. on ac power with the lid closed, it always works.
what privacy concerns are there?
no network calls. no telemetry. caffeinagent reads files inside ~/.claude/projects and scans process names on your own machine. that’s the entire footprint.
what macos versions?
macos 14 sonoma or later. universal binary, runs natively on apple silicon and intel.
do i need to install a privileged helper or weird permissions?
only if you want the on-battery override. otherwise: no daemons, no helpers. just a menu bar app and an iopmassertion.
what if my agent isn’t in the default list?
open preferences. type the process name. it’s a simple allowlist you control.