Skip to content
OpenSmartRoute
Skillv1.0.0

anti-sleep

Keep a Mac awake with caffeinate during long builds, downloads, or supervised automation runs.

by sickn33(0) 0 installs
Free
Sign in to install

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Imported from sickn33/agentic-awesome-skills (skills/anti-sleep/SKILL.md). Install upstream with npx skills add sickn33/agentic-awesome-skills --skill anti-sleep. Copyright stays with the author (MIT).

Anti-Sleep (macOS caffeinate)

When to Use

  • Use when the user wants the Mac to stay awake during a long supervised task.
  • Use when a build, download, or automation run should not be interrupted by sleep.

Keep the Mac awake using the built-in caffeinate command. No install needed.

Quick start — the standard command

caffeinate -d -i -t 7200    # full power: screen stays on + no idle sleep, for 2 hours

Duration is -t <seconds>: 2h = 7200, 7h = 25200, overnight (9h) = 32400.

Aggressiveness levels

Flags Effect
-i prevents idle system sleep only (screen may still dim/lock)
-d prevents display sleep (screen stays on)
-d -i default choice — screen on + system awake
-d -i -s adds -s: prevents sleep even on AC power semantics; -s only works when plugged in
-u -t 1 simulates user activity — wakes the display right now

Default to -d -i -t <seconds> unless the user says otherwise.

Tie to a process instead of a timer

caffeinate -d -i -w <PID>          # stays awake until that process exits (great for builds)
caffeinate -i npm run build       # wraps a command; exits when the command finishes

Run it in a visible terminal (cmux pane)

Prefer running it in the user's own terminal pane so it's visible and easy to Ctrl+C. In cmux (read the cmux skill first if interacting with panes):

cmux send --surface surface:<N> "caffeinate -d -i -t 25200\n"

Otherwise run it as a background Bash task. Never block your own foreground shell with it.

Verify and monitor

pgrep -fl caffeinate                       # is it running? shows exact flags
ps -o etime= -p <PID>                      # how long it's been running
pmset -g assertions | grep -i deny        # confirm sleep assertions are active

Gotcha: caffeinate prints nothing and holds the prompt — it looks "stuck" or like Enter wasn't pressed. It isn't stuck. Verify with pgrep, not by looking at the terminal.

Expiry: with -t it exits silently when time runs out — no notification. If the user asks "is it still on?" after hours, check pgrep first; it may simply have expired.

Keyboard backlight

caffeinate cannot keep the keyboard backlight on — it has its own inactivity timer with no CLI/API on Apple Silicon (researched 2026-07). Fix is manual, one-time: System Settings > Keyboard > "Turn keyboard backlight off after inactivity" > Never.

Stop early

pkill -f "caffeinate -d -i"    # or Ctrl+C in the pane running it

After starting: confirm to the user the PID, the flags, and the wall-clock time it will expire.

Limitations

  • Adapted from davidondrej/skills; verify local paths, tools, credentials, and agent features before acting.
  • For commands, remote access, scheduling, browser automation, or file-changing workflows, get explicit user approval and confirm the target environment first.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml
targets:
  - https://api.opensmartroute.ai/api/v1/registry/sickn33-agentic-awesome-skills-anti-sleep/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

sickn33-agentic-awesome-skills-anti-sleep.ocm.jsonjson
{
  "ocm": "1",
  "id": "sickn33-agentic-awesome-skills-anti-sleep",
  "kind": "skill",
  "name": "anti-sleep",
  "description": "Keep a Mac awake with caffeinate during long builds, downloads, or supervised automation runs.",
  "publisher": "sickn33",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "macos",
      "caffeinate",
      "operations",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Keep a Mac awake with caffeinate during long builds, downloads, or supervised automation runs."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/sickn33/agentic-awesome-skills",
      "path": "skills/anti-sleep/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/sickn33/agentic-awesome-skills/blob/HEAD/skills/anti-sleep/SKILL.md",
      "key": "sickn33/agentic-awesome-skills/skills/anti-sleep/SKILL.md"
    },
    "license": "MIT"
  },
  "instructions": "# Anti-Sleep (macOS caffeinate)\n\n## When to Use\n\n- Use when the user wants the Mac to stay awake during a long supervised task.\n- Use when a build, download, or automation run should not be interrupted by sleep.\n\nKeep the Mac awake using the built-in `caffeinate` command. No install needed.\n\n## Quick start — the standard command\n\n```bash\ncaffeinate -d -i -t 7200    # full power: screen stays on + no idle sleep, for 2 hours\n```\n\nDuration is `-t <seconds>`: 2h = 7200, 7h = 25200, overnight (9h) = 32400.\n\n## Aggressiveness levels\n\n| Flags | Effect |\n|---|---|\n| `-i` | prevents idle **system** sle",
  "cost": {
    "context_tokens": 740
  }
}

Fetch it by URL: GET /api/v1/registry/sickn33-agentic-awesome-skills-anti-sleep/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.