Apple Apps & ServicesDocumentedScanned

caffeine

Prevent the computer screen and system from falling asleep on macOS or Windows.

Share:

Installation

npx clawhub@latest install caffeine

View the full skill documentation and source below.

Documentation

Caffeine

Keeps your computer awake by preventing display and system sleep.

Quick Start

macOS

caffeinate -d

Windows (PowerShell)

# Keep display awake until Ctrl+C
while ($true) {
  $wsh = New-Object -ComObject WScript.Shell
  $wsh.SendKeys('{SCROLLLOCK}{SCROLLLOCK}')
  Start-Sleep -Seconds 60
}

macOS

Uses the built-in caffeinate command (no installation needed).

Options

CommandEffect
caffeinatePrevent sleep until terminated
caffeinate -dPrevent display from sleeping
caffeinate -iPrevent idle sleep
caffeinate -sPrevent system sleep (AC power only)
caffeinate -t 3600Prevent sleep for 1 hour (seconds)
caffeinate -d -t 1800Keep display on for 30 minutes

Examples

Keep display on for 2 hours:

caffeinate -d -t 7200

Keep awake while a command runs:

caffeinate -i -- long-running-command

Run in background:

caffeinate -d &
# To stop later:
pkill caffeinate

Check if running:

pgrep -l caffeinate

Windows

Option 1: PowerShell (no install)

Prevent sleep by simulating activity (Ctrl+C to stop):

while ($true) {
  $wsh = New-Object -ComObject WScript.Shell
  $wsh.SendKeys('{SCROLLLOCK}{SCROLLLOCK}')
  Start-Sleep -Seconds 60
}

Option 2: powercfg (change power settings)

Disable sleep temporarily:

# Disable sleep on AC power
powercfg /change standby-timeout-ac 0
powercfg /change monitor-timeout-ac 0

# Re-enable later (e.g., 30 minutes)
powercfg /change standby-timeout-ac 30
powercfg /change monitor-timeout-ac 15

Option 3: Presentation mode

# Enable presentation mode (disables sleep + notifications)
presentationsettings /start

# Disable when done
presentationsettings /stop

Option 4: One-liner with .NET

# Prevent sleep for duration of script
Add-Type -AssemblyName System.Windows.Forms
while ($true) {
  [System.Windows.Forms.Cursor]::Position = [System.Windows.Forms.Cursor]::Position
  Start-Sleep -Seconds 60
}

Notes

  • macOS: caffeinate is built-in; process must stay running
  • Windows: PowerShell methods simulate activity; powercfg changes system settings
  • Press Ctrl+C to stop any running script