Releases: zetagao/LimitHUD
LimitHUD v2.3 — Proactive alerts
What's new in v2.3
Proactive alerts — LimitHUD now warns you before you even open the card:
- 🔥 Forecast alert — when a window is projected to run dry before it resets (within ~30 min).
- ⚡ Pace alert — when you're burning ~2× your usual rate and already under 50% left, so you catch a runaway session early.
Both are edge-detected with a 2-hour cooldown — they fire once per episode, never spam. Toggle in Settings → Reminders (on by default); they respect quiet hours + sound like the other reminders.
Recover a stuck card — a new Reset appearance button (Settings → Card) instantly restores the default dark look (drops custom colors + opacity).
Tappable sign-in fixes — when Claude / Codex shows an error or stale data, click it to jump straight to the site and re-sign-in. Plus a clearer Codex message: "Token expired — re-sign in."
Update
`brew upgrade --cask limithud` — or download LimitHUD.zip below.
LimitHUD v2.2 — Forecast & faster-than-usual alert
What's new in v2.2
Burn-down forecast, drawn out — the card's sparkline now extends a dashed line projecting your usage all the way to empty, so you can see when you'll run dry, not just read it.
"Faster than usual" alert 🔥 — LimitHUD learns your typical burn rate, and when you're spending abnormally fast the forecast line turns orange: "burning ~2× your usual pace." Catch a runaway session before it drains you.
A redesigned pet companion — the mascot is now a set of illustrated, animated animals (Mochi · Lota · Bao · Mozart). It reacts to your tightest quota — calm when you've got room, subdued as it tightens, dozing when spent, a little celebration on a refill — and otherwise just rests quietly, out of your way.
Refreshed Settings — restyled to match the card's deep-dark frosted look, plus hotkey-conflict detection (it tells you when your toggle shortcut is already taken by another app).
Privacy is unchanged: cookies are read locally, only `claude.ai` / `chatgpt.com` are ever contacted, nothing is logged or phoned home.
Update
`brew upgrade --cask limithud` — or download LimitHUD.zip below.
LimitHUD v2.1 — Meet your quota pet
LimitHUD gets a mascot. A little pixel creature lives on the card and reacts to your quota — relaxed when you're flush, frantic when you're nearly out, partying when it refills.
What's new
A living quota pet 🐾
- Pick your buddy in Settings → Pet: Mochi · Cat · Ghost · Dog. Each is drawn procedurally (no image assets) in a soft pixel-mosaic style with a Morandi palette.
- Its mood tracks your tightest window — happy ≥50%, uneasy under 50%, panicking under 20%, asleep when there's no data, and it throws confetti when a window refills.
- Fully animated: breathing with squash & stretch, blinks, eye darts — and a different set of actions per character and per mood (a healthy dog does zoomies; a panicking one frantically headbutts the bubble to warn you).
It plays with its speech bubble
- The bubble talks in each pet's own voice, and is now translucent so it adapts to any custom card background.
- The pet physically interacts with it — nudges, swats, phases through, squishes — and pulls off eight different "smash" finishers (shatter, gravity-drop, pixel-dissolve, crumple, fling, melt, roll-up, spring-stretch), two assigned to each character as signatures.
Also
- Real frosted-glass card background.
- Refill celebration: glow pulse + rolling numbers.
- Steadier pet mood (no gray flicker during a refresh).
- Menu bar stays clean — just the tightest quota %, colored by state.
Install
Download LimitHUD.zip, unzip, drag to Applications. First launch: right-click → Open (self-signed). Reads Claude & Codex quota locally from your browser cookies.
LimitHUD v2.0 — Menu-bar-first
A big interaction overhaul: LimitHUD now lives in your menu bar and stays out of the way until quota actually matters.
What's new
Menu-bar-first
- The menu bar shows your tightest quota as a colored % — neutral when healthy, amber under 50%, red under 20%.
- Left-click to peek a card right under the icon; it auto-dismisses when you click away (popover-style).
- Hit 📌 pin to keep the card as a persistent floating HUD.
Bottleneck hero
- The card now leads with the single most-constrained window across Claude & Codex — large %, bar, and reset countdown — so you instantly see your real ceiling.
Burn-rate forecast 🔥
- Tracks your usage over time and shows "empty in ~22m at this rate" — but only when running out would beat the reset, so it never cries wolf.
- A mini sparkline of recent usage sits in the hero.
Also
- Position memory now applies to both peek and pinned cards.
Install
Download LimitHUD.zip, unzip, drag to Applications. First launch: right-click → Open (self-signed). Reads Claude & Codex quota from your browser cookies, all local.
LimitHUD v1.8
Fixed (hardening pass)
- 🖥️ Card can't get lost off-screen — the remembered position is now clamped onto a real screen, so disconnecting an external monitor won't hide it.
- 🔄 Always-fresh quota — usage requests bypass any local HTTP cache.
- 🧹 Hotkey recorder no longer leaks its key monitor if you close Settings mid-recording.
⬇️ Download LimitHUD.zip below — drag to Applications, right-click → Open.
Full changelog: v1.7...v1.8
LimitHUD v1.7
Fixed — Claude stability
The flapping between OK / “Session expired” / “Read failed” was a Cloudflare challenge, not an expired session. Our hardcoded Chrome/124 user-agent never matched your browser's cf_clearance cookie, so requests kept getting challenged.
- 🪪 User-Agent now matches your installed Chrome's real version (+ proper
sec-ch-ua/sec-fetchheaders) so the session cookie validates - 🏷️ Clearer errors: Cloudflare check vs Session expired vs Rate limited
- 💾 Stale fallback — a failed refresh keeps the last good data with a
last HH:mmmarker instead of blanking to an error
New
- ✨ 12 more menu-bar icons — sparkles, flame, moon & stars, leaf, drop, star, heart, atom, waveform, cloud, checkered…
⬇️ Download LimitHUD.zip below — drag to Applications, right-click → Open.
Full changelog: v1.6...v1.7
LimitHUD v1.6
Fixed
- 🔁 Intermittent "Session expired" on Claude — when Chrome rotated its session cookie, LimitHUD could read a stale token (the new one was still in the DB's write-ahead log) and get a 401. It now reads the freshest cookie, so the card stays stable across auto-refreshes.
⬇️ Download LimitHUD.zip below — drag to Applications, right-click → Open.
Full changelog: v1.5...v1.6
LimitHUD v1.5
New
- 📊 Custom progress-bar color — turn it on in Settings → Card to make all bars (and their %) a single color of your choice, instead of the green/amber/red health ramp. Combine with custom background + text color for a fully themed card.
⬇️ Download LimitHUD.zip below — drag to Applications, right-click → Open.
Full changelog: v1.4...v1.5
LimitHUD v1.4
New
- 🎨 Custom text color — pick any text color (pair it with a custom background for e.g. blue-on-green). The
%and bars stay green/amber/red so you can still read quota health at a glance. - 🪪 Friendly profile names — the Browser → Profile dropdown now shows each profile's name and account email (e.g. Work · you@work.com), so it's obvious which Google account you're picking.
⬇️ Download LimitHUD.zip below — drag to Applications, right-click → Open.
Full changelog: v1.3...v1.4
LimitHUD v1.3
Fixed
- 👥 Claude and Codex can now use different accounts — set a separate browser/profile per provider in Settings → Browser. Previously both were read from one profile, so if your Claude and ChatGPT logins lived in different Chrome profiles (different Google accounts), only one would show.
⬇️ Download LimitHUD.zip below — drag to Applications, right-click → Open.
Full changelog: v1.2...v1.3