Control Keepresso from Shortcuts, Raycast, or a script

Keepresso is a menu-bar click, but you can also drive it hands-off from Shortcuts, Spotlight, Siri, Raycast, Alfred, or any script, using its Shortcuts actions and URL scheme.

Shortcuts actions

Keepresso ships native Shortcuts actions you can drop into any shortcut, or run straight from Spotlight and Siri:

• Start Keeping Awake (optionally for a set number of minutes)
• Stop Keeping Awake
• Toggle Keep Awake

URL scheme

For Raycast, Alfred, or a shell script, open a keepresso:// URL:

keepresso://start              start an open-ended session
keepresso://start?duration=60  start for 60 minutes
keepresso://start?until=18:00  keep awake until 18:00
keepresso://stop               stop the session
keepresso://toggle             toggle it

From a terminal or a script, open "keepresso://start?duration=90" does the same. If you would rather use a real command with a proper exit code and status, reach for the keepresso command-line tool.

They stick

Any command from Shortcuts or a URL pauses your triggers first, so the session you asked for actually holds, instead of a trigger rule overriding it a second later.