Skip to content

Releases: zetagao/LimitHUD

LimitHUD v2.3 — Proactive alerts

17 Jun 06:14

Choose a tag to compare

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

15 Jun 15:06

Choose a tag to compare

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

13 Jun 08:13

Choose a tag to compare

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

11 Jun 06:36

Choose a tag to compare

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

11 Jun 05:37

Choose a tag to compare

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

11 Jun 05:31

Choose a tag to compare

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-fetch headers) 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:mm marker 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

10 Jun 12:08

Choose a tag to compare

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

10 Jun 10:26

Choose a tag to compare

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

10 Jun 10:23

Choose a tag to compare

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

10 Jun 10:16

Choose a tag to compare

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