☕️ coffee

Keep your Mac awake even though you close the lid of your Mac, coffee toggles macOS sleep prevention (pmset -a disablesleep) from the command line.

Install

Homebrew

brew tap mrthiti/coffee
brew install --cask coffee

This downloads the prebuilt binary for your Mac (Apple Silicon or Intel) from the same GitHub Releases used by install.sh — no Go or build step required — and installs it to your Homebrew bin. It also sets up the same passwordless-sudo rule as install.sh (you may be prompted for your password once during install), so plain coffee just works afterward. brew uninstall --cask coffee removes that sudoers rule again automatically.

The Cask itself lives in mrthiti/homebrew-coffee and is kept in sync automatically whenever a new release is tagged here.

install.sh

curl -fsSL https://raw.githubusercontent.com/mrthiti/coffee/main/install.sh | sh

This downloads the latest build binary for your Mac (Apple Silicon or Intel) from GitHub Releases, installs it to /usr/local/bin/coffee, and grants your user passwordless sudo for exactly pmset -a disablesleep 0/1 — nothing else — via /etc/sudoers.d/coffee, so plain coffee never needs a password afterwards. If that last step fails (e.g. you decline the password prompt), the binary is still installed — just use sudo coffee instead.

Update

curl -fsSL https://raw.githubusercontent.com/mrthiti/coffee/main/install.sh | sh

Same command as install — it overwrites the existing binary with the latest release. Run coffee --version before and after to confirm it updated.

Uninstall

If you installed via Homebrew:

brew uninstall --cask coffee

This removes the binary and the sudoers rule automatically.

If you installed via install.sh or built from source:

sudo pmset -a disablesleep 0
sudo rm /usr/local/bin/coffee /etc/sudoers.d/coffee

If coffee is currently running in the foreground, press Ctrl+C first — it disables sleep prevention on exit automatically. Drop the /etc/sudoers.d/coffee part if install.sh never got to set it up (e.g. you declined the password prompt). coffee installs a single binary with no config file, LaunchAgent, or background daemon, so removing it is enough.

Usage

coffee                Run in the foreground: enables sleep prevention and
                      keeps re-checking it (macOS can silently reset it,
                      e.g. when switching between AC and battery power),
                      then disables it again on exit (press Ctrl+C to stop).
coffee status         Show the current sleep-prevention status.
coffee --help         Show this help message.
coffee --version      Show the installed version.

Both Homebrew and install.sh (see "Install" above) set up passwordless sudo for you, so plain coffee normally just works. If you built from source instead and want the same thing, add this to a file under /etc/sudoers.d/ yourself (validate with visudo -c -f <file> before it takes effect):

<your-username> ALL=(root) NOPASSWD: /usr/bin/pmset -a disablesleep 0, /usr/bin/pmset -a disablesleep 1

Without that, plain coffee only works if you already have a cached sudo credential; otherwise run it as sudo coffee instead. status never needs a password.

Requirements

• macOS (Intel or Apple Silicon)

Building from source

git clone https://github.com/mrthiti/coffee.git
cd coffee
go build -o coffee .

Releasing (maintainers)

Push a tag matching v* (e.g. git tag v1.1.0 && git push origin v1.1.0). .github/workflows/release.yml builds both binaries, publishes them as a GitHub Release, and pushes an updated Casks/coffee.rb to mrthiti/homebrew-coffee — cutting the tag is the only manual step.

That last part needs a one-time setup: a fine-grained Personal Access Token scoped to just the homebrew-coffee repo with Contents: Read and write, saved as a repository secret named HOMEBREW_TAP_TOKEN on this repo (Settings → Secrets and variables → Actions). Without it, the tap-update step fails loudly and the Cask has to be updated by hand.

License

MIT