SleepWalk

Ask your assistant to handle the session.

Install the skill and lightweight CLI. Say do not sleep or invoke $sleepwalk; your assistant starts a bounded session, then stops it when the work is done.

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.

---
name: sleepwalk
description: Use SleepWalk when the user says "do not sleep", asks to keep this Mac awake for a long-running task, invokes $sleepwalk, or asks to wrap a command.
---

# 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

1. Check availability:

```bash
sleepwalkctl status
```

If unavailable, ask the user to open SleepWalk or install the CLI from Settings.

2. Start a lease for the requested long task:

```bash
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.

3. Always release that lease when the task completes or genuinely stops:

```bash
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:

```bash
sleepwalkctl run -- <command>
```

Do not start SleepWalk for ordinary short commands. Never disable its safeguards.

sleepwalkctl manages bounded keep-awake sessions for SleepWalk.

Usage:
  sleepwalkctl status
  sleepwalkctl active
  sleepwalkctl start [options]
  sleepwalkctl stop [options]
  sleepwalkctl run [options] -- command [args...]

Commands:
  status   Show the app, session, battery, and thermal state.
  active   Print whether a session is active.
  start    Start a bounded keep-awake session.
  stop     Stop the current session.
  run      Keep awake while a command runs.

Start and run options:
  -d, --duration <time>       Stop after a duration such as 30m or 1h.
  -b, --battery-floor <pct>   Stop below a battery percentage.
  -l, --label <text>          Name the session.
      --thermal-stop <level>  Stop at fair, serious, or critical.

Stop option:
      --reason <text>         Explain why the session stopped.

Agent options:
      --source <name>         Identify the calling agent.
      --agent-session-id <id> Manage only that agent's lease.

General option:
  -h, --help                  Show this help.

Examples:
  sleepwalkctl start --duration 30m --battery-floor 20
  sleepwalkctl run -- npm test
  sleepwalkctl stop --reason "tests passed"

Frequently Asked Questions

Who is SleepWalk for?

SleepWalk is for developers who need to step away while an agent, build, server, or script keeps running.

Can I close my MacBook lid while an agent is running?

Yes. Start a bounded session, close the lid, and let the agent continue while SleepWalk watches your limits.

How is SleepWalk different from Caffeine, Amphetamine, caffeinate, or pmset?

Those tools keep a Mac awake. SleepWalk adds a short session flow, closed-lid use, battery and thermal limits, and simple agent start/stop commands.

Can the agent start and stop SleepWalk itself?

Yes. Install the SleepWalk skill once, and an AI coding agent can start a bounded session and stop it when the task is done.

Which agents does SleepWalk support?

Any agent, editor, terminal, script, or workflow that can call the local SleepWalk CLI.

Does SleepWalk watch my editor, prompts, or terminal output?

No. SleepWalk does not inspect prompts, windows, logs, code, or network traffic. Agent setup uses explicit local commands from the SleepWalk skill and CLI.

What happens when a limit is reached?

SleepWalk ends the session when the timer expires, the battery drops below your floor, the Mac gets too hot, or a local stop command ends the session.

How much does SleepWalk cost?

SleepWalk is buy-once software. Current price, promo, and trial details are shown at Polar checkout.

Close the lid. Let the agent finish.

Works with every agent

Ask your assistant to handle the session.

SleepWalk

Workflow

Set limits before you walk away

Time limit

Battery floor

Temperature watch

Frequently Asked Questions