SleepWalk
SleepWalk is a local macOS app for bounded keep-awake sessions. It does not inspect prompts, code, logs, windows, or network traffic.
Use it only for an explicit keep-awake request or a genuinely long-running command.
Workflow
- Check availability:
sleepwalkctl status
If unavailable, ask the user to open SleepWalk or install the CLI from Settings.
- Start a lease for the requested long task:
sleepwalkctl start --source codex --agent-session-id "<stable-id>" --label "<short label>"
Reuse the same ID. Add duration, battery, or thermal flags only when the user requests them.
- Always release that lease when the task completes or genuinely stops:
sleepwalkctl stop --source codex --agent-session-id "<stable-id>" --reason "<brief reason>"
This releases only this agent lease and never kills user processes.
For one long non-interactive command:
sleepwalkctl run -- <command>
Do not start SleepWalk for ordinary short commands. Never disable its safeguards.