Close Your MacBook Lid Without Killing Your AI Agents (Open-Source macOS Keep-Awake)
Every time you close your MacBook lid on battery or unplug your display to walk to a meeting, macOS enters clamshell sleep. Your SSH sessions drop, your Docker builds freeze, and your background AI coding agents die mid-run.
caffeinate -dims only prevents idle sleep while the lid is open. To keep a MacBook running with the lid closed, macOS requires toggling pmset -a disablesleep 1 at the kernel power management layer—which is risky if you forget it on and throw your laptop into a backpack.
So I built and open-sourced Awake (il.ly) — a tiny native macOS 26 Control Center widget, Menu Bar timer, and CLI (awake / asleep) that keeps your MacBook running with the lid closed, locks the screen the instant the lid shuts, and automatically re-enables sleep if the battery temp hits 40°C or drops to 10%.
!Awake for macOS
What It Does
1. Works with the lid closed on battery or AC: Combines pmset -a disablesleep 1 with caffeinate -dims and live IOKit AppleClamshellState monitoring.
2. Instant screen lock on lid close: The moment the lid closes while Awake is active, it locks your session so an awake MacBook is never an unlocked MacBook.
3. Backpack thermal & battery circuit breaker: Polls AppleSmartBattery every 30 seconds in-process via IORegistry. If battery temperature reaches >= 40°C (like inside a closed sleeve or backpack) or charge drops to <= 10%, Awake immediately trips the breaker and lets the Mac sleep, then auto-resumes once cooled or plugged in.
4. macOS 26 Control Center + Menu Bar + CLI: Toggle from Control Center, pick a countdown timer (30m, 1h, 2h, 4h, or indefinite) from the Menu Bar espresso cup, or wrap a long command from the terminal:
# Install via script or Homebrew
curl -fsSL https://il.ly/awake/install.sh | sh
# or: brew install --cask illyism/awake/awake
# Keep awake for 2 hours
awake 2h
# Keep awake until a specific command finishes
awake -- bun run build
Links
- GitHub Repository (MIT): Illyism/awake
- Interactive Overview & DMG Download: il.ly
Mentions
Close Your MacBook Lid Without Killing Your AI Agents (Open-Source macOS Keep-Awake) Every time you close your MacBook lid on battery or unplug your display to walk to a meeting, macOS enters clamshell sleep. Your SSH sessions drop, your Docker builds freeze, and your background AI coding agents die mid-run. caffeinate -dims only prevents idle sleep while the lid is open. To keep a MacBook running with the lid closed, macOS requires toggling pmset -a disablesleep 1 at the kernel power management layer—which is risky if you forget it on and throw your laptop into a backpack. So I built and open-sourced Awake (il.ly) — a tiny native macOS 26 Control Center widget, Menu Bar timer, and CLI (awake / asleep) that keeps your MacBook running with the lid closed, locks the screen the instant the lid shuts, and automatically re-enables sleep if the battery temp hits 40°C or drops to 10%. !Awake for macOS What It Does 1. Works with the lid closed on battery or AC: Combines pmset -a disablesleep 1 with caffeinate -dims and live IOKit AppleClamshellState monitoring. 2. Instant screen lock on lid close: The moment the lid closes while Awake is active, it locks your session so an awake MacBook is never an unlocked MacBook. 3. Backpack thermal & battery circuit breaker: Polls AppleSmartBattery every 30 seconds in-process via IORegistry. If battery temperature reaches >= 40°C (like inside a closed sleeve or backpack) or charge drops to <= 10%, Awake immediately trips the breaker and lets the Mac sleep, then auto-resumes once cooled or plugged in. 4. macOS 26 Control Center + Menu Bar + CLI: Toggle from Control Center, pick a countdown timer (30m, 1h, 2h, 4h, or indefinite) from the Menu Bar espresso cup, or wrap a long command from the terminal: # Install via script or Homebrew curl -fsSL https://il.ly/awake/install.sh | sh # or: brew install --cask illyism/awake/awake # Keep awake for 2 hours awake 2h # Keep awake until a specific command finishes awake -- bun run build Links - GitHub Repository (MIT): Illyism/awake - Interactive Overview & DMG Download: il.ly