@mohitkumawat/warmup-cli 1.2.1 → 1.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +53 -36
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,13 +1,19 @@
|
|
|
1
1
|
<div align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/Tarikul-Islam-Anik/Animated-Fluent-Emojis/master/Emojis/Food/Hot%20Beverage.png" alt="WarmUp Logo" width="100" />
|
|
2
3
|
|
|
3
|
-
# ☕
|
|
4
|
+
# ☕ WarmUp
|
|
4
5
|
|
|
5
|
-
**Pre-warm your Claude rate limits while you sleep
|
|
6
|
-
|
|
6
|
+
**Pre-warm your Claude rate limits while you sleep.**
|
|
7
|
+
|
|
8
|
+
*One command. Zero daily effort. Full Claude capacity precisely when you need it.*
|
|
7
9
|
|
|
8
|
-
|
|
9
|
-
[](https://opensource.org/licenses/MIT)
|
|
10
|
+
<br />
|
|
10
11
|
|
|
12
|
+
[](https://www.npmjs.com/package/@mohitkumawat/warmup-cli)
|
|
13
|
+
[](https://opensource.org/licenses/MIT)
|
|
14
|
+
[](https://www.npmjs.com/package/@mohitkumawat/warmup-cli)
|
|
15
|
+
|
|
16
|
+
<br />
|
|
11
17
|
</div>
|
|
12
18
|
|
|
13
19
|
---
|
|
@@ -18,77 +24,88 @@ Claude Pro and Max subscribers share a **5-hour rolling rate limit window** acro
|
|
|
18
24
|
|
|
19
25
|
## 🟢 The Solution
|
|
20
26
|
|
|
21
|
-
**`warmup`** starts your rate limit window
|
|
27
|
+
**`warmup`** starts your rate limit window *before* you wake up by scheduling one tiny Claude Code ping (~10 tokens) at the exact right time.
|
|
22
28
|
|
|
23
29
|
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.
|
|
24
30
|
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
> 12:00 PM → Window resets instantly. Full capacity continues.
|
|
31
|
+
### ⏱️ Side-by-Side Comparison
|
|
32
|
+
|
|
33
|
+
| ❌ Without `warmup` | ✅ With `warmup` (2-hour exhaustion) |
|
|
34
|
+
| :--- | :--- |
|
|
35
|
+
| **10:00 AM** → You start working, window starts. | **7:00 AM** → `warmup` sends one tiny ping (window starts). |
|
|
36
|
+
| **12:00 PM** → **Rate limited!** 🛑 Must wait until 3:00 PM. | **10:00 AM** → You start working using the active window. |
|
|
37
|
+
| **1:00 PM** → Still waiting... ⏳ | **12:00 PM** → You exhaust your limits, BUT the 7:00 AM window ends right now! |
|
|
38
|
+
| **2:00 PM** → Still waiting... ⏳ | **12:01 PM** → **Window resets instantly.** 🚀 Full capacity continues. |
|
|
34
39
|
|
|
35
|
-
|
|
40
|
+
> ***You just saved over 3 hours of waiting.***
|
|
36
41
|
|
|
37
42
|
---
|
|
38
43
|
|
|
39
|
-
## ⚡
|
|
44
|
+
## ⚡ Installation
|
|
40
45
|
|
|
41
46
|
```bash
|
|
42
47
|
npm install -g @mohitkumawat/warmup-cli
|
|
43
48
|
```
|
|
44
|
-
|
|
49
|
+
|
|
50
|
+
> **Note:** *Prerequisites: [Claude Code](https://code.claude.com) must be installed and authenticated.*
|
|
51
|
+
|
|
52
|
+
---
|
|
45
53
|
|
|
46
54
|
## 🚀 Quick Start
|
|
47
55
|
|
|
56
|
+
Run the following command anywhere in your terminal:
|
|
57
|
+
|
|
48
58
|
```bash
|
|
49
59
|
warmup
|
|
50
60
|
```
|
|
51
61
|
|
|
52
|
-
Fresh installs open a **guided onboarding wizard
|
|
62
|
+
*Fresh installs open a **guided onboarding wizard**.*
|
|
53
63
|
|
|
54
|
-
### 🔍 What happens
|
|
55
|
-
* Shows the exact background command (`claude -p ping --max-turns 1`) transparently.
|
|
56
|
-
* Asks about your typical work schedule.
|
|
57
|
-
* Shows a detailed geometric preview of the scheduled timeline before explicitly asking for confirmation.
|
|
58
|
-
* Stores config and logs purely locally in `~/.warmup/`.
|
|
64
|
+
### 🔍 What happens behind the scenes?
|
|
59
65
|
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
66
|
+
- 📜 Shows the exact background command (`claude -p ping --max-turns 1`) transparently.
|
|
67
|
+
- 🕒 Asks about your typical work schedule.
|
|
68
|
+
- 📊 Shows a detailed geometric preview of the scheduled timeline before explicitly asking for confirmation.
|
|
69
|
+
- 💾 Stores config and logs purely locally in `~/.warmup/`.
|
|
70
|
+
|
|
71
|
+
### 🛡 What DOES NOT happen?
|
|
72
|
+
|
|
73
|
+
- ❌ Setup does **not** send a live Claude request or burn any limits.
|
|
74
|
+
- ❌ `warmup` does **not** proxy your session, extract tokens, or phone home to any backend API. Privacy first.
|
|
63
75
|
|
|
64
76
|
---
|
|
65
77
|
|
|
66
78
|
## 🧠 Smart Setup
|
|
67
79
|
|
|
68
|
-
We don't ask you to do modulo-math to figure out your 5-hour window. `warmup` asks you two plain-English questions:
|
|
69
|
-
|
|
70
|
-
|
|
80
|
+
We don't ask you to do modulo-math to figure out your 5-hour window. `warmup` simply asks you two plain-English questions:
|
|
81
|
+
|
|
82
|
+
1. **When do you start working?** *(e.g., 9:00 AM)*
|
|
83
|
+
2. **How quickly do you exhaust limits?** *(e.g., 1-2 hours)*
|
|
71
84
|
|
|
72
85
|
It then automatically calculates the **exact optimal pre-warm time** to ensure your rate limit resets exactly the minute you run out of messages.
|
|
73
86
|
|
|
87
|
+
---
|
|
88
|
+
|
|
74
89
|
## 🛡️ Bulletproof Boot-Recovery
|
|
75
90
|
|
|
76
91
|
**What if my computer is off or asleep at the scheduled pre-warm time?**
|
|
77
92
|
|
|
78
|
-
`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).
|
|
93
|
+
`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).
|
|
79
94
|
|
|
80
95
|
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.
|
|
81
96
|
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
97
|
+
| OS | Background Mechanism |
|
|
98
|
+
| :--- | :--- |
|
|
99
|
+
| 🍎 **macOS** | `launchd` via `RunAtLoad` |
|
|
100
|
+
| 🐧 **Linux** | `systemd` timers via `Persistent=true` |
|
|
101
|
+
| 🪟 **Windows** | `schtasks` via `StartWhenAvailable` |
|
|
85
102
|
|
|
86
103
|
---
|
|
87
104
|
|
|
88
|
-
## 🛠️ Commands
|
|
105
|
+
## 🛠️ Commands Reference
|
|
89
106
|
|
|
90
107
|
| Command | Description |
|
|
91
|
-
|
|
108
|
+
| :--- | :--- |
|
|
92
109
|
| `warmup setup` | Smart interactive setup wizard |
|
|
93
110
|
| `warmup status` | Show schedule and live window progress bar |
|
|
94
111
|
| `warmup test` | Fire a pre-warm right now |
|