faruksayfa3-commits/vigil-mac

Close the lid. Your AI agent keeps working. The moment it's done, the Mac goes to sleep.
Wakeful is a tiny open-source menu-bar app (Swift, universal Intel + Apple Silicon, macOS 12+) for people who leave
Claude Code, Codex, aider, builds, rsync or backups running overnight — and don't want a Mac that either
falls asleep at 3 a.m. and kills the job, or stays awake forever and cooks itself in a backpack.
## Why not Amphetamine / Caffeine / KeepingYouAwake?
| | Amphetamine | KeepingYouAwake | Caffeine | Wakeful |
| Keep awake for a time | ✅ | ✅ | ✅ | ✅ |
| Lid closed, no external display | needs a helper script | ❌ | ❌ | ✅ |
| Stays awake only while an agent / task is actually working | ❌ | ❌ | ❌ | ✅ |
| Stays awake while an SSH / Screen Sharing session is open | partial | ❌ | ❌ | ✅ |
| Sleeps on low battery / battery budget / overheating / "backpack mode" | partial | ❌ | ❌ | ✅ |
| "Looks stuck" detector | ❌ | ❌ | ❌ | ✅ |
| Phone notifications + phone commands (panic button) | ❌ | ❌ | ❌ | ✅ |
| CLI, URL scheme, hooks, Home Assistant webhook | ❌ | CLI | ❌ | ✅ |
| Morning report + shareable night card | ❌ | ❌ | ❌ | ✅ |
## Features
Agent-aware. Watches claude, codex, aider, gemini, cursor-agent (CPU + child-process activity) and tasks like rsync, xcodebuild, cargo, brew, ffmpeg. Awake while they work, asleep when they finish. Edit the lists in Settings → Watch.
Remote-aware. An open SSH login or Screen Sharing session keeps the Mac up.
Safety first. Auto-sleep when the battery is low, when a battery budget is used ("this night may use 30%"), when it overheats, and in backpack mode (lid closed + on battery + warming up). Warns before it acts.
Stuck detector. A watched process is alive but silent for 15 minutes → you get a notification instead of a dead night.
Lock on lid close. The Mac stays awake but the screen locks; display turns off; Wi-Fi is kept alive; Low Power Mode on battery.
Phone. Notifications through ntfy. Send off, on 2h or status to -cmd from your phone — a panic button with no open ports.
Timers & schedules. 30 min … 24 h, "until 07:00", wait-for-process, weekly schedules (Settings → Schedules).
Night report + card. Hours awake, battery used, peak temperature, what finished, score and streak — as Markdown and a 1080×1920 PNG you can post.
Moods. The menu-bar icon (eye / cat / robot) sleeps, wakes, gets tired, sweats when hot and smiles when done.
Fan check. Hot at low CPU for 5+ minutes → "dust or a blocked vent?".
Hackable. wakeful CLI, wakeful:// URL scheme (Shortcuts: Open URL), hooks/{on,off,finished,guard}.d/ scripts, webhook for Home Assistant.
Settings window (menu → Settings…, ⌘,). Every option without editing JSON: watched agents and tasks, battery and heat limits, lid behaviour, icon, ntfy server and topic, webhook, schedules. Changes apply at once.
Health check. On first launch, and from the menu any time: is the sudoers rule in place, is ntfy reachable, is the CLI installed, is there a temperature sensor and a lid. Anything missing comes with the exact command to fix it. The same in Terminal: wakeful doctor.
Launch at login from the menu, and Check for updates…, which asks GitHub only when you click it and opens the release page. Nothing auto-installs.