☕ WarmUp

Pre-warm your Claude rate limits while you sleep.

One command. Zero daily effort. Full Claude capacity precisely when you need it.

🛑 The Problem

Claude Pro and Max subscribers share a 5-hour rolling rate limit window across Claude Code, Cowork, and claude.ai. When you start an intensive coding session, you burn through your allocation quickly and are forced to wait 2-3 hours for the window to reset.

🟢 The Solution

warmup starts your rate limit window before you wake up by scheduling one tiny Claude Code ping (~10 tokens) at the exact right time.

By the time you sit down to work, the window is perfectly timed to expire exactly when you need it, granting you a 100% fresh allocation right in the middle of your workday.

⏱️ Side-by-Side Comparison

| ❌ Without warmup | ✅ With warmup (2-hour exhaustion) | | :--- | :--- | | 10:00 AM → You start working, window starts. | 7:00 AM → warmup sends one tiny ping (window starts). | | 12:00 PM → Rate limited! 🛑 Must wait until 3:00 PM. | 10:00 AM → You start working using the active window. | | 1:00 PM → Still waiting... ⏳ | 12:00 PM → You exhaust your limits, BUT the 7:00 AM window ends right now! | | 2:00 PM → Still waiting... ⏳ | 12:01 PM → Window resets instantly. 🚀 Full capacity continues. |

You just saved over 3 hours of waiting.

⚡ Installation

npm install -g @mohitkumawat/warmup-cli

Note: Prerequisites: Claude Code must be installed and authenticated.

🚀 Quick Start

Run the following command anywhere in your terminal:

warmup

Fresh installs open a guided onboarding wizard.

🔍 What happens behind the scenes?

• 📜 Shows the exact background command (claude -p ping --max-turns 1) transparently.
• 🕒 Asks about your typical work schedule.
• 📊 Shows a detailed geometric preview of the scheduled timeline before explicitly asking for confirmation.
• 💾 Stores config and logs purely locally in ~/.warmup/.

🛡 What DOES NOT happen?

• ❌ Setup does not send a live Claude request or burn any limits.
• ❌ warmup does not proxy your session, extract tokens, or phone home to any backend API. Privacy first.

🧠 Smart Setup

We don't ask you to do modulo-math to figure out your 5-hour window. warmup simply asks you two plain-English questions:

1. When do you start working? (e.g., 9:00 AM)
2. How quickly do you exhaust limits? (e.g., 1-2 hours)

It then automatically calculates the exact optimal pre-warm time to ensure your rate limit resets exactly the minute you run out of messages.

🛡️ Bulletproof Boot-Recovery

What if my computer is off or asleep at the scheduled pre-warm time?

warmup handles this automatically using native OS features. If your laptop was closed at your 5:00 AM pre-warm time, the pre-warm fires immediately upon waking your machine (e.g., at 8:00 AM).

It has built-in deduplication guards: it will never double-fire or accidentally consume a second rate-limit window, even if you restart your computer 10 times a day.

| OS | Background Mechanism | | :--- | :--- | | 🍎 macOS | launchd via RunAtLoad | | 🐧 Linux | systemd timers via Persistent=true | | 🪟 Windows | schtasks via StartWhenAvailable |

🛠️ Commands Reference

| Command | Description | | :--- | :--- | | warmup setup | Smart interactive setup wizard | | warmup status | Show schedule and live window progress bar | | warmup test | Fire a pre-warm right now | | warmup update | Change your schedule / re-run the smart wizard | | warmup pause | Pause the daily schedule | | warmup resume | Resume the daily schedule | | warmup uninstall | Remove the background task |

❓ FAQ