pi-caffeinated

A Pi extension that adds a /caffeinate command for keeping your machine awake. It starts a platform-native keep-awake process in the background and shows a centered coffee-break modal while it runs.

Features

• /caffeinate toggles a platform-native keep-awake process
• Centered overlay modal that captures input while running
• Escape stops caffeinate and closes the modal
• Animated mug, computer, and elapsed timer
• Status bar indicator while caffeinate is active
• Cleans up the background process when Pi shuts down

Platform support

Platform	Mechanism	Requires
macOS	caffeinate -dimsu	Built in
Linux	systemd-inhibit --what=idle:sleep ... sleep infinity	systemd-inhibit on systemd-based distros
Windows	PowerShell calling SetThreadExecutionState(ES_CONTINUOUS | ES_SYSTEM_REQUIRED)	PowerShell

Install

pi install npm:pi-caffeinated

Restart Pi after installing or updating the extension.

Usage

Run the command inside Pi:

/caffeinate

Press Esc in the modal to stop. Running /caffeinate again also toggles it off.

Requirements

• Pi coding agent extension runtime
• One supported keep-awake backend from the platform table above

License

MIT