Caffeine — Development skill for Claude Code
Keep your Mac awake while you work, then let it sleep when your coding agent waits for you.
How to install Caffeine
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open iannuttall/caffeine and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Caffeine does
Keep your Mac awake while you work, then let it sleep when your coding agent waits for you.
Alternatives in Development
- Book To Skill — Turn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work 25.9k ★
- Remind — Set or manage custom reminders that surface in Claude Code while you work 100 ★
- Cc Caffeine — ☕️ Prevents your computer from sleeping while Claude Code works hard 70 ★
README
Caffeine
**Keep your Mac awake while you work, then let it sleep when your coding agent waits for you.**
[Releases](https://github.com/iannuttall/caffeine/releases) · [Report a problem](https://github.com/iannuttall/caffeine/issues) · MIT licensed
What Caffeine does
Caffeine keeps the cup and one-click toggle that made the original Mac app so good. Click it once to keep your Mac awake. Click again and macOS can sleep normally. A full cup means a manual session is active.
Agent Watch adds a small blue dot when a coding agent owns the awake session. Optional hooks for Claude Code and Codex follow the actual turn. Caffeine turns on when work starts and releases its power assertions when the agent finishes or waits for your input.
The app also includes timers, battery protection, display sleep controls, a best-effort closed-lid mode, and a view of other processes currently blocking sleep.
Credit to the original Caffeine
Tomas Franzén of Lighthead Software created Caffeine in 2006. Michael Jones and IntelliScape Computer Solutions carried it forward from 2018 after Tomas released the source under an open source license. The open source project was modernized again in 2022. The [official Caffeine FAQ](https://www.caffeine-app.net/en/) tells the full story.
This project is an independent Swift rewrite. It keeps the original interaction and MIT-licensed menu-bar artwork, then adds Agent Watch for coding agents.
Install Caffeine
Caffeine supports Apple silicon and Intel Macs running macOS 14 or later.
Download the latest DMG from [GitHub Releases](https://github.com/iannuttall/caffeine/releases), open it, and drag Caffeine to Applications. The app does not need administrator access or a privileged helper. Launch at Login is optional and can be changed in Settings.
Agent Watch follows active turns
Open Settings > Agents and install the optional lifec
Related Skills
Agent Caffeine
Keep macOS awake while a CLI coding agent works, and let it sleep when the network dies
Goguma
Wakes your Mac for scheduled jobs, holds it awake while long work finishes, and lets it sleep otherwise. Finds
Agents Dont Sleep
Close the lid, let your agents cook. A tiny tray app that keeps your laptop awake (lid shut, in your bag) only
Agents Sleep Preventer
Keep your Mac awake while Claude Code or Codex is working
Drem
A native macOS menu-bar companion that keeps your Mac awake while Codex and Claude Code work.
Nightly
Work while you sleep — a host-native autonomous coding agent that lands draft PRs by morning.
Related Agents
macOS System Operator
Mac housekeeping and CLI operations — installing tools (brew/npm/curl installers), logins that open a browser,
Issue Team PM
PM agent for issue-team skill. Feature-only. Writes the spec, waits for team-lead approval, briefs Dev and QA,
Desk Runner
Complete one briefed native Mac app task in the background through desk tools, then return a filtered read and
