---
slug: "pi-caffeinated"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/tanishqkancharla/pi-caffeinated@main/README.md"
repo: "https://github.com/tanishqkancharla/pi-caffeinated"
source_file: "README.md"
branch: "main"
---
<img width="1536" height="768" alt="tanishqk_A_busy_cluttered_cafe-diner_in_the_early_morning_sun_b9ac1268-7b0b-4464-9e0e-5c918d5c5877_0" src="https://github.com/user-attachments/assets/52809be9-6bec-497d-8bce-d78f42e70548" />

# 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.

<img width="2117" height="2160" alt="image" src="https://github.com/user-attachments/assets/cee11bc9-8225-4b7f-b4f2-ec5c3429c67b" />

## 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

```sh
pi install npm:pi-caffeinated
```

Restart Pi after installing or updating the extension.

## Usage

Run the command inside Pi:

```text
/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