majiayu000

Caff — Development skill for Claude Code

Development community

macOS menu bar app that keeps the Mac awake during long-running agent tasks (Swift + IOKit).

How to install Caff

This entry records only its repository, not the path inside it, so there is no exact command to give. Open majiayu000/caff and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Caff does

macOS menu bar app that keeps the Mac awake during long-running agent tasks (Swift + IOKit).

Alternatives in Development

Quosparr — 🐦 Native menu bar & tray app for macOS, Windows and Linux: track Codex, Claude Code and Grok quotas, resets 288 ★
Cc Bar — Native macOS menu bar app: track quota, usage and cost for Codex (multi-account) and Claude Code, from your me 119 ★
Agent Cat Releases — Agent Cat downloads — a free macOS menu bar and Windows tray app that shows Claude Code, Codex and Gemini CLI 57 ★

README

Caff

[![CI](https://github.com/majiayu000/caff/actions/workflows/ci.yml/badge.svg)](https://github.com/majiayu000/caff/actions/workflows/ci.yml) [![test](https://github.com/majiayu000/caff/actions/workflows/test.yml/badge.svg)](https://github.com/majiayu000/caff/actions/workflows/test.yml) [![Release](https://img.shields.io/github/v/release/majiayu000/caff)](https://github.com/majiayu000/caff/releases/latest) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

Caff is a small macOS menu bar app that keeps the machine awake while long-running agent tasks are active. It can be driven manually, by agent hook events, or by CLI/URL commands.

[Install](#install) · [Quick Start](#quick-start) · [Why Caff?](#why-caff) · [Star on GitHub](https://github.com/majiayu000/caff)

brew install --cask majiayu000/caff/caff

![Caff control window](media/caff-control-window.png)

Why Caff?

Long-running agent work usually fails in unglamorous ways: a Mac sleeps, the network drops, or an interactive Codex/Claude turn stops mid-task.

Caff is for the gap between "keep the whole machine awake forever" and "hope macOS stays awake long enough":

keep the Mac awake while complex agent or long-context tasks are running
avoid leaving a raw caffeinate command open in a terminal
use visible manual timers, safety limits, and optional display-awake control
refresh wake locks from explicit agent-touch hook events instead of guessing from process names