Vibe Caffeine keeps your Mac awake while AI coding tools (Claude Code, Codex, OpenCode, pi) are working. No more interrupted tasks due to system sleep.
The app runs in your menu bar with a simple icon:
| Icon | Meaning |
|---|---|
| 🍵 | idle — No AI tools are working, Mac can sleep |
| ☕️ | active — AI tool is working, sleep prevented |
| 🔒 | manual — Manually force Mac awake |
Left-click the icon to switch between Auto and Manual modes.
Installation
Homebrew (Recommended)
brew install jjyr/tap/vibe-caffeine
Manual Installation
Download the latest release from GitHub Releases, unzip, and move Vibe Caffeine.app to /Applications.
Usage
- Left-click — Toggle between Auto and Manual modes
- Right-click — Open menu with status info, Launch at Login toggle, and Quit option
Development
Requirements
- macOS 13.0+
- Swift 5.9+
- Xcode Command Line Tools
Build Commands
# Debug build make build # Release build (creates .app bundle) make release # Run debug executable make run # Run the .app bundle make run-app # Install to /Applications make install # Clean build artifacts make clean
Project Structure
Sources/VibeCaffeine/
├── App/
│ └── AppDelegate.swift # Application lifecycle
├── Features/
│ ├── FileMonitoring/
│ │ ├── FileMonitor.swift # FSEvents directory watching
│ │ └── AIToolDetector.swift # Monitored paths configuration
│ ├── MenuBar/
│ │ └── MenuBarManager.swift # Menu bar UI and interactions
│ └── SleepPrevention/
│ └── SleepManager.swift # IOKit sleep assertion control
└── State/
└── AppState.swift # Central state machine
Technical Details
- Sleep Prevention: Uses IOKit's
IOPMAssertionCreateWithNamewithkIOPMAssertionTypeNoDisplaySleep - File Monitoring: CoreServices FSEventStream with 1-second latency
- Zero Dependencies: Pure Swift using only system frameworks (IOKit, AppKit)
- Background App: Runs as a menu bar-only app without a Dock icon