# Holdor

> Holds the door. So your agents don't have to stop.

Holdor is a free, open-source native macOS menu bar app that prevents your system from sleeping while agentic AI tools are running. It is signed and notarized by Apple.

## Problem
Company security policies require locking your screen when you step away. But when macOS locks, it eventually sleeps — killing long-running AI agents like Claude, Cursor, Windsurf, and VS Code coding assistants. The workaround of carrying your laptop everywhere is absurd.

## How It Works
Holdor uses macOS's built-in `caffeinate` command, tied to each app's process ID. In Regular mode (`caffeinate -i -w <PID>`) it prevents idle sleep. In Extended mode (`caffeinate -i -s -w <PID>`) it also prevents system sleep (e.g. lid close). Both modes allow the display to sleep normally. When the watched app quits, the caffeinate assertion is automatically released.

## Features
- Native macOS menu bar app (Swift/SwiftUI, no Electron)
- Watches multiple apps simultaneously
- Auto-detects when apps launch or quit
- Built-in support for Claude Desktop, Cursor, Windsurf, VS Code, Zed, ChatGPT, Warp, Terminal, iTerm, and Ghostty
- Terminal apps cover CLI-based AI tools like Claude Code and OpenCode
- Add any custom app via native Finder file picker
- Built-in Lock Screen button
- Pause/resume protection
- Launch at login support
- Remembers preferences across restarts
- Signed and notarized by Apple — no Gatekeeper warnings

## FAQ
- **Does Holdor drain battery?** No. It's a native Swift app with negligible resource usage. It only prevents idle sleep while watched apps are running.
- **Can I lock my screen?** Yes — that's the point. Display sleeps and screen locks normally. Only idle sleep is prevented.
- **Which apps are supported?** 10 built-in apps plus any custom app via Finder. Terminal apps cover CLI tools like Claude Code.

## Technical Details
- Platform: macOS 13 (Ventura) or later
- Architecture: ARM64 (Apple Silicon)
- Language: Swift 5.9+
- Build system: Swift Package Manager
- License: MIT
- Repository: https://github.com/johannesnagl/holdor
- Website: https://holdor.yetanother.one
- Download: https://github.com/johannesnagl/holdor/releases/download/v1.4.3/Holdor-1.4.3-arm64.dmg

## Building
```bash
cd app
swift build -c release
```

## Author
Johannes Nagl — https://github.com/johannesnagl — https://www.linkedin.com/in/johannesnagl/