caflisted
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