keep your mac awake
while ai agents work.
caffeinagent watches your ai coding agents. holds your mac awake while they're running. lets it sleep the moment they're done or waiting for you.
macos 14+ · signed & notarized · no telemetry
keeping mac awake
the problem
you launch a 20-minute claude code task.
you close the lid.
you come back to nothing.
mac sleeps. agent dies. work lost.
you've seen the photo: real ai engineers stacking macbooks to run more codex agents in parallel. that works until one of those lids closes the wrong way.
@openaidevs · 1.2m views →how it works
agent-aware, not just a coffee cup.
watches claude code transcripts
tails ~/.claude/projects/*.jsonl for every active session. distinguishes active vs waiting-for-input vs idle.
watches your agent processes
scans the process list every 5s for 40+ known cli agents. opencode, codex, goose, aider, gemini, and anything you add.
holds the mac awake on ac
uses iopmassertion preventsystemsleep. lid closes, mac stays alive, agent keeps running.
overrides on battery (optional)
one-time admin prompt installs a scoped sudoers entry, then caffeinagent toggles `pmset disablesleep` only while an agent is actually running.
sleeps when work's done
the moment every agent goes idle or waits for your input, caffeinagent releases the assertion. battery saved.
detects
every agent you run.
based on the skills.sh supported-agents list. add your own from the preferences panel.
one price
$5
one-time. lifetime updates. no subscription.
buy caffeinagentsigned · notarized · gatekeeper-clean
faq
questions.
does it work with the lid closed on battery?
yes, if you grant the one-time sudoers install. on apple silicon the underlying pmset override isn’t guaranteed on every model (apple has been progressively tightening clamshell sleep). on ac power with the lid closed, it always works.
what privacy is involved?
no network calls. no telemetry. caffeinagent reads files in ~/.claude/projects and scans process names on your machine. that’s it.
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 permissions, no daemons. just a menu bar app.
what if my agent isn’t in the list?
open preferences and add the process name. it’s a simple allowlist you control.