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

Nexting — Remote control for Claude Code, Codex, Grok, and Cursor on Mac or PC 1.3k ★
Huashu Mac Use — 让任何 agent 操控 Mac 上没有 API 的原生 app，读后台、写不打扰、每步留取证 · Agent Skill for macOS computer use 228 ★
Cc Bar — Native macOS menu bar app: track quota, usage and cost for Codex (multi-account) and Claude Code, from your me 119 ★

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