Your Mac sleeps the instant your agent stops.
Running Claude Code, Cursor, ollama or a long CLI job with the lid closed? agent-awake keeps the machine awake only while that process is actually working — then lets it sleep the second it ends. No more 3 a.m. fan roar and a dead battery because you forgot to quit caffeinate.
Why not just caffeinate?
Because caffeinate doesn't know when your work is done. You start it, the agent finishes in 20 minutes, and your laptop stays wide awake on battery for the next 6 hours.
Dumb caffeinate -t 99999
- Awake the whole time — even after the job ends
- You forget to kill it → battery gone by morning
- No idea why the Mac is awake
- Lid-closed = space heater
agent-awake
- Awake only while your whitelisted agent runs
- Sleeps within seconds of the job finishing
- Live "why am I awake" status + battery-saved counter
- Optional phone ping the moment your agent is done
Built for long agent runs
Whitelist the processes that matter and let the lid close. agent-awake watches them and nothing else.
Process-aware
Detects Claude Code, Cursor, ollama, node CLIs — any process you whitelist by name or regex. Awake follows the work, not a timer.
"Why am I awake?"
One command shows exactly which process is holding the machine awake, with PIDs. No more guessing.
Battery-saved counter
Tracks the wake-time you avoided versus a dumb always-on caffeinate and estimates the watt-hours you kept.
Unlimited rules (Pro)
Whitelist every tool in your stack — not just one. Substring or full regex matching.
Schedules (Pro)
Only allow keep-awake inside work hours. Outside the window the Mac sleeps even mid-job.
Phone alert (Pro+)
Get a push the instant your agent finishes — walk away from the laptop and still know when the run is done.
Up and running in 30 seconds
No account, no daemon to install. It's one command.
npx agent-awake watch
Default whitelist already covers Claude Code, Cursor and ollama. Add your own: agent-awake rules add "My build" "/vite|webpack/"
Simple, one-time pricing
No subscriptions. Buy once, own it. Prices in USD and INR.
- Keep awake while 1 process runs
- Live "why am I awake" status
- Battery-saved counter
- Unlimited rules
- Schedules & usage log
- Phone notifications
- Unlimited process rules
- Work-hour schedules
- Usage log of every awake session
- Everything in Free
Razorpay (UPI/cards) & Stripe. GST invoice on request.
- Everything in Pro
- Phone notification when your agent finishes
- Priority email support
License is an offline-verifiable key — paste it into agent-awake activate.
FAQ
Does it work with the lid closed?
Yes — that's the whole point. While your whitelisted agent runs, agent-awake holds caffeinate so a clamshell Mac keeps working. The moment the agent exits, it releases and your Mac sleeps.
How is this different from Amphetamine or just caffeinate?
Those keep you awake on a timer or until you manually stop. agent-awake is process-aware: it ties wakefulness to whether your agent process is actually running, so you never leave the machine awake by accident.
Is my data sent anywhere?
No. The CLI runs entirely on your machine and verifies your license key offline with an embedded public key. Phone notifications (Pro+) are the only outbound call, and only if you turn them on.
What does "battery saved" mean?
It's an estimate of the wake-time you avoided compared to leaving caffeinate on the whole time, converted to watt-hours. It's clearly labeled as an estimate.
Is there a menu-bar app?
The CLI ships first and is the full engine. A native menu-bar wrapper is on the roadmap — agent-awake status --json already exposes everything it needs.