Repository navigation
Matcha 1.3.1
A minimalist macOS keep-awake app that also prevents the screen saver and lock screen, with first-class automation for scripts and AI agents.
Highlights
- Keeps the Mac awake and the display unlocked for a chosen duration or until stopped
- A soft matcha wash fills the main window while a session is active
- Typed durations (
8,2.5h,1d,2h 30m), presets, and a resizable floating indicator - One-command install and update, with checksum verification and automatic agent setup
- Check for Updates… in the app menu
- Friendly uninstall script that also removes agent instructions
- Optional live countdown (or infinity) beside the menu bar icon
- Global hotkeys:
Ctrl-Opt-Cmd-Mtoggles,Ctrl-Opt-Cmd-1starts one hour - Five-minute ending warning with Add 1 Hour / Stop; auto-extends 30 minutes while a build is still running
- Auto-keep-awake for real build/encode tools, plus a low battery guard
- Sessions survive crashes and force-quits; an intentional Quit ends them
- CLI,
matcha://URL scheme, and a status plist for agents - Agent kit auto-configures Claude Code, opencode, Codex CLI, Gemini CLI, and Windsurf; project rules for Cursor and Aider
- No accounts, analytics, or telemetry
Install and uninstall instructions live in the README.