iannuttall

Caffeine — Development skill for Claude Code

Development community

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 ★
Om Intake — Process all unread meeting notes in work/meetings/ — reads each file, classifies content, routes to the right 4.6k ★
Contributing To Auto-claude-code-research-in-sleep (aris) — English 中文版 Thank you for your interest in contributing to ARIS 3.1k ★

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.