# quotawake quotawake is a small [[Open Source]] utility by [[Ivo Velitchkov]] that restarts [[Claude Code]] work when your usage limit resets. [[MIT License]], PowerShell, **Windows only**. Its own summary: *"Claude Code stops when you hit a usage limit. Quotawake starts the work again when the limit is reset; when you are asleep, away from your computer, or there but busy with something else."* ## The problem You give an agent a long task, walk away, and come back to a frozen window that says `You've hit your session limit · resets 8pm`. The four hours between are dead. Worse, nothing outside a running Claude Code session can type into that window, so no amount of clever scripting revives it. ## What it does quotawake reads the reset time out of Claude's own message, sets an alarm, and exits. That last word is the design decision worth noticing. Between the limit and the reset there is **no process at all**. No polling loop, no daemon, no CPU or memory. The operating system scheduler does the waiting, which means the resume survives closing the window that started it, and survives sleep or a reboot. At reset time the work carries on in a **new** session carrying the full history of the old one. It has to be new; the frozen window cannot be revived. You get told three ways: a desktop notification, a `QUOTAWAKE-RESUMED.md` file dropped in the project folder, and a fresh entry in the Claude app, phone included. Finding your way back in: ```powershell claude agents # resumed sessions are named "<project> – resumed 20:04" qw -List # only what quotawake resumed, plus running/done state claude attach <id> # open it here claude logs <id> # peek without opening ``` Sessions carry two ids, since the resumed session is a different session. `QUOTAWAKE-RESUMED.md` records both, labelled *Session that stopped* and *Resumed session*. ## Installation, and what it touches Requires Windows, PowerShell 7+, and `claude` on your PATH. ```powershell .\quotawake.ps1 -Install # then open a NEW shell .\quotawake.ps1 -Doctor # prove it actually works on this machine ``` `-Install` writes to four per-user places, none needing admin: a Scheduled Task (the reconciler), your user PATH, your PowerShell profile (for the `qw` shortcut), and the Startup folder (the keep-awake watcher). `-Uninstall` reverses all four. `-Doctor` registers a real scheduled job, confirms the system can see it, then removes it. The README says it was added after silent failures, which is a good sign about how the author works. ## Caveats worth keeping - **Early release.** First commit 2026-08-01. Used daily by its author, and openly flagged as young with rough edges. - **Windows only.** Ports to macOS and [[Linux]] are explicitly invited. - **The machine must stay awake and plugged in** for the resume to land on time. If it sleeps through the reset, work starts when you next wake it. - **Don't type `resume` into the old frozen window.** It cannot see any of this, so you get a second run doing work the resumed session already did, burning tokens twice. ## Why I keep this note Two reasons, and neither is "I will install this" (I'm not on Windows). The first is the pattern: **schedule, then exit**. The obvious build here is a background process that polls until the quota comes back. The better build hands the waiting to the OS and disappears, which costs nothing and survives reboots. That trade shows up constantly in automation work, and the polling version usually wins by default because it's easier to imagine. The second is what it says about how agent work is changing. A tool exists to bridge the gap between quota windows because people now start tasks they expect to outlive their own attention. The bottleneck stopped being how fast the agent works and became how much of it you're allowed to buy per window. Tooling grows around whatever is scarce. ## References - [quotawake on GitHub](https://github.com/kvistgaard/quotawake) ## Related - [[Claude Code]] - [[AI Agents]] - [[AI Agent Harness]] - [[Ivo Velitchkov]] - [[Anthropic]] - [[Linux]] - [[Open Source]] - [[MIT License]]