jaagte-raho
Keep your computer awake while Claude Code is working, and only then.
You give Claude a two-hour task and go get lunch. Twenty minutes later your laptop goes to sleep, and the task stops with it.
jaagte-raho is a Claude Code plugin that holds off sleep while Claude is working. When Claude finishes, the computer goes back to sleeping normally. No config, no admin rights, nothing to remember to switch off.
/plugin marketplace add vibhusharma101/jaagte-raho
/plugin install jaagte-raho@jaagte-raho
Start a new session and you're done.
What it does
| What's happening | Computer |
|---|
| Session open, nothing running | sleeps normally |
| You sent a prompt, Claude is working | kept awake |
| Claude finished, background agents/tasks still running | kept awake |
| Claude finished, nothing in the background | sleeps normally (within ~2 s) |
| You interrupted a turn (Esc) | sleeps normally (within ~60 s) |
| Claude exited or crashed | sleeps normally |
With several sessions open, the computer stays awake while any of them is working. Leave four finished sessions open overnight and the laptop still sleeps.
Why not just caffeinate, Amphetamine or PowerToys Awake?
Those tools keep the machine awake until you turn them off, or for a fixed time. You have to guess how long Claude will take, and if you forget to turn them off, your battery pays for it.
jaagte-raho follows what Claude is actually doing:
- Awake only while a turn is running, including background agents and tasks that outlive the turn.
- Sleeps again on its own once Claude is idle, interrupted, or closed.
- Safe if something crashes. The lock is tied to the Claude process, so if Claude dies, the OS releases the lock. Nothing is left holding your machine awake.
- Handles many sessions. Each session holds its own lock.
- Same behaviour on macOS, Windows and Linux, with nothing extra to install.
You can always see whether it's working
Every session start shows one line:
jaagte-raho: on. Keeps this computer awake while Claude is working, lets it sleep when idle
It only says that after checking that this machine actually lets it take the lock. If it can't, it says so and why, instead of failing silently.
For details, run:
/jaagte-raho:status
It lists every watched session by its folder and the start of your last prompt, whether Claude is working in it, whether the lock is really held, any recent error, and what the OS itself reports. Paste this into bug reports.
Session d4bca0fb (session-city): Claude working | watcher PID 37516 | AWAKE (lock held)
folder: C:/Users/you/code/session-city
last prompt (2m ago): "Redo the labels so they don't overlap when 25 sessions are running"
Each session holds its own lock; the computer stays awake while any one of them shows AWAKE.
How it works
On SessionStart, a hook finds the Claude Code process and starts a small background watcher for the session. The watcher holds the OS keep-awake lock only while the session is marked busy:
| Hook | Effect |
|---|
UserPromptSubmit | mark busy |
Stop | clear busy, unless its background_tasks list is non-empty |
Notification (idle_prompt) | clear busy. Claude Code sends it ~60 s after a turn ends, only once no background agent is running, so it also covers interrupted turns |
SessionEnd | stop the watcher |
The hooks only create or delete a flag file, so prompts are never slowed down. What holds the machine awake while busy:
| OS | Lock |
|---|
| macOS | caffeinate -i -w <claude pid> |
| Linux | systemd-inhibit --what=idle:sleep |
| Windows | PowerSetRequest (system + execution + display) |
When Claude exits, normally or by crashing, the watcher exits and the OS releases the lock.
Waiting for permission: while Claude is waiting for you to approve a tool, the turn isn't over, so the computer stays awake. That's deliberate: if you approve from your phone via Remote Control, a sleeping laptop couldn't continue.
Options
| Env var | Effect |
|---|
JAAGTE_RAHO_DISPLAY=0 | Windows: allow the screen to turn off. Saves battery, but on Modern Standby laptops (powercfg /a shows "S0 Low Power Idle") the screen turning off can put the machine into standby. |
This is the beginning of the README. Read the rest at the original. Read the full README ↗
