← ClaudeAtlas

caflisted

Keep a Mac awake for a long-running job — a shell-agnostic `caf` wrapper around `caffeinate` (on/off/status, human durations like "2 hour", optional `--lid` to survive closing the lid via `pmset disablesleep`, auto-reverted when the timer expires, and a screen blackout that darkens the built-in display while the lid is shut and restores the brightness on open). Use to start/stop/inspect the keep-awake state on this Mac from any shell, or to install the whole setup (script + one-time sudoers grant) on a fresh Mac. Do NOT use for scheduling wakeups, `pmset` power profiles, or Linux/Windows sleep settings.
savchenko-dev/caf · ★ 2 · Web & Frontend · score 63
Install: claude install-skill savchenko-dev/caf
# caf — keep the Mac awake from any shell `caf` is a small POSIX-`sh` script wrapping `caffeinate` with a pidfile, human-readable durations, and an opt-in lid-close override. It is a plain executable, so it behaves identically from `sh`, `bash`, `zsh`, `fish`, or a non-interactive agent shell. Script: `~/.claude/skills/caf/caf` (run it by full path if it isn't on PATH). ## Commands | Command | Effect | | --- | --- | | `caf on` | keep awake indefinitely (closing the lid still sleeps) | | `caf on 2 hour` | keep awake for 2 hours; `15 min`, `30 sec`, `1.5 hour`, `hour` also work | | `caf on --lid` | also disable lid-close sleep, indefinitely | | `caf on --lid 2 hour` | also disable lid-close sleep; auto-restored when the timer expires | | `caf on --lid --no-dim` | keep the lid override but leave the screen lit | | `caf extend 1 hour` | add time to a running caf without dropping the lid override | | `caf off` | kill the caffeinate process, restore lid-close sleep and brightness | | `caf status` | caffeinate ON/OFF (with until-time + time left for a timed run) + lid-close and screen-blackout state | | `caf build` | precompile the screen-blackout helper (`caf-dim`) | | `caf install-sudoers` | one-time setup so `--lid` needs no password (prompts for sudo) | Durations are parsed by `/usr/bin/units`, so they need a space: `2 hour`, not `2h`. Unparseable input fails loudly instead of silently caffeinating forever. ## Behaviour worth knowing - **Background process, not a shell jo