Manage caffeinate

Skill ArthurZakirov/AgentDesk/skills/manage-caffeinate

Make any machine ready for human and AI-agent work.

Install

npx -y skills add ArthurZakirov/AgentDesk --skill manage-caffeinate

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Turn macOS caffeinate sleep prevention on or off, check its status, or explain the launchd-backed setup. Use when the user says to enable, disable, start, stop, toggle, inspect, or troubleshoot caffeinate / coffee Nate / keep-awake behavior for local terminal, Codex, Claude Code, or other agent workflows.

SKILL.md

2.4 KB, 490 tokens by cl100k_base, as published. Nobody here has run it

Manage Caffeinate

Overview

Use this skill to manage a machine-level macOS caffeinate job. This is not Codex-specific; it keeps the Mac awake for any local terminal, Codex, Claude Code, browser, or agent process that depends on the machine staying awake.

The preferred mechanism is a launchd-managed job named agentdesk-caffeinate, which runs:

/usr/bin/caffeinate -dimsu

Workflow

Run the bundled script from the installed skill:

bash "$HOME/.codex/skills/manage-caffeinate/scripts/manage-caffeinate.sh" status
bash "$HOME/.codex/skills/manage-caffeinate/scripts/manage-caffeinate.sh" on
bash "$HOME/.codex/skills/manage-caffeinate/scripts/manage-caffeinate.sh" off

If the skill is being run from a cloned AgentDesk checkout instead of an installed Codex skill, run:

bash "skills/manage-caffeinate/scripts/manage-caffeinate.sh" status

Commands

on: create or refresh the launchd job. Also removes the legacy codex-caffeinate label if present.
off: remove the launchd job and clean up matching managed /usr/bin/caffeinate -dimsu processes.
status: show launchd status and pmset -g assertions caffeinate lines.
restart: remove and recreate the launchd job.

Verification

After turning it on, verify pmset -g assertions lists /usr/bin/caffeinate or a caffeinate command-line tool assertion with PreventUserIdleSystemSleep, PreventUserIdleDisplaySleep, and PreventSystemSleep.

After turning it off, verify launchctl list agentdesk-caffeinate fails and pmset -g assertions no longer lists the caffeinate assertions.

Reference

Read references/setup.md when you need to explain how the launchd setup works, why launchd is used instead of a background shell process, or what was initially configured on Arthur's machine.

Boundaries

caffeinate prevents idle sleep while macOS allows the assertion. Closing a MacBook lid can still force sleep unless the machine is in a supported clamshell setup, typically connected to power and external display/input.