@synthryn/sypi-caffeinate
v0.6.0-beta.20260816.6a00fcae
Published
Optional extension: Keep the system awake during long agent runs with the platform's native inhibitor. Use it when unattended work must not be interrupted by sleep. Primary capability: /caffeinate; it uses caffeinate, systemd-inhibit, or PowerShell when a
Downloads
79
Maintainers
Readme
@synthryn/sypi-caffeinate
Optional SyPi keep-awake controls. No external binary is bundled. During an
agent run, /caffeinate uses the platform's native inhibitor: caffeinate on
macOS, systemd-inhibit on Linux, and PowerShell execution-state calls on
Windows and WSL. Linux installations without systemd-inhibit can use a
separately installed caffeinate command or an explicitly configured custom
inhibitor instead.
The package is opt-in and fail-open. If no supported inhibitor is available, SyPi stays usable and reports the unavailable optional capability. It never needs an account, API key, token, password, keyring, or network access. The catalog discloses the platform tools before installation.
/caffeinate opens a centered board in TUI mode. Direct routes are:
/caffeinate display- keep the system and display awake/caffeinate sleep- keep the system awake while allowing display sleep/caffeinate status- show the selected mode and current inhibitor state/caffeinate stop- release the inhibitor until the next agent run
The selected mode is stored under ~/.sypi/caffeinate/settings.json; no
project repository state is created. Settings contain only the versioned mode
and update timestamp. Set SYPI_CAFFEINATE_COMMAND to an
argv-style custom inhibitor command when the platform's native tool is not
available; it is executed without a shell and remains optional.
