Cuppa
A macOS menu-bar app that keeps the Mac awake while agents work.
- Context
- Personal project
- Year
- 2026
- Role
- Sole author
- Stack
- Swift, SwiftUI, AppKit, Vision
The problem
Long agent runs died whenever the MacBook slept, and a dozen small utilities each did one thing. Cuppa is one coffee cup in the menu bar that handles all of it.
- Native, light, and safe with secrets.
- Never approve anything destructive on my behalf.
Architecture
What I built
- 01Awake modes: for a time, until a time, while a command runs, or while agents are busy, lid closed included, driven by Claude Code hooks.
- 02A ⌘⇧V clipboard history that spots copied API keys, locks them in the Keychain and asks for Touch ID to paste.
- 03Auto-approval of safe Claude Code permission prompts: fixed rules first, then a model that may only allow or escalate. Destructive commands always escalate, and every decision is logged.
- 04On-device text recognition, per-display video wallpapers and a drop shelf.
By the numbers
- Swift tests passing
- 180
- CLI checks in a throwaway HOME
- 153