Awake — Development skill for Claude Code

awake

Keep your Mac running with the lid closed. Safe by default, built for humans and agents.

[](https://awake.crafter.run)

macOS force-sleeps a laptop when the lid closes, no matter what `caffeinate` says. The only switch that overrides it is `pmset -a disablesleep 1`, which needs root. `awake` wraps that switch with the ergonomics and guardrails it deserves:

• Auto-off timer by default. awake on keeps the Mac awake for 1 hour and then restores normal sleep on its own (via a launchd agent), so a forgotten toggle cannot drain your battery overnight.
• One-time passwordless setup. awake setup installs a sudoers rule scoped to exactly two commands (pmset -a disablesleep 1 and ... 0) - nothing else gets elevated, and awake setup --uninstall removes it.
• Visible state. The menu bar app shows a sun icon plus a live countdown while active, and notifies when the auto-off fires.
• Agent-friendly. Every command supports --json, output follows a stable envelope, and exit codes are meaningful.

Install

bun install
bun run link:global      # builds and links the `awake` command
awake setup              # one-time: authorizes passwordless toggling

Usage

awake on            # stay awake for 1 hour (default)
awake on 3h         # stay awake for 3 hours ("30m", "1h30m", "45" = minutes)
awake on --forever  # no timer - until you run awake off
awake off           # restore normal sleep now
awake status        # current state, timer, battery

Menu bar app

A native SwiftUI menu bar companion (macOS 13+) that drives the same CLI:

./mac/build-app.sh
open mac/dist/Awake.app

• Moon icon: off. Sun icon + countdown (e.g. 42m): the Mac is being kept awake.
• Toggle on for 30 min / 1 h / 2 h / until turned off; turn off any time.
• In "forever" mode it reminds you every 30 minutes tha