Releases: Yovancas/claudebar-win
Release list
v0.3.9 — honest quota, polished glance
ClaudeBar for Windows v0.3.9 — honest quota, polished glance 🎯
A big jump from v0.3.7 — this release bundles the audit sprint (v0.3.8) and a full UX polish pass (v0.3.9).
Updating from an earlier version? It installs itself — the app checks on launch, or right-click → Check for updates.
📊 Honest quota & data
- Dynamic model families — Fable, Mythos and any future model show up on their own with their name and colour, and drop off when they leave the window. Your Fable spend now actually counts (it used to read €0).
- Pricing without hardcoding — rates pulled from models.dev with a local cache and an embedded offline snapshot. Privacy toggle in Settings → System ("Update rates online") that sends nothing about you.
- Coherent quota bar — the bar colour now tracks the real % (green → amber → red); the burn rate moved to the pace marker. No more "57% in red / 84% in green".
- Per-window pace — the pace line colours each window (5h / 7d) by its own state and splits out the run-out estimate.
👁️ More legible
- Tray icon — "99+" reads in full and the pending badge keeps its shape (readable without colour).
- WCAG contrast across the panel, DPI scaling (125 / 150%) and locale-aware formats (amounts and dates), with no clipped text.
- Mascot — visible even when idle, the "working" animation is a clean arc, and the quota-reset celebration uses the brand colour.
- Chart — threshold lines in % mode, clearer legend and axes.
⚙️ Settings
- The panel remembers its scroll position, the back button reads as "‹ Back", and groups are better organised.
🔒 Under the hood
- Atomic credential writes (can't log Claude Code out), 717 automated tests, and signed auto-update (Ed25519).
/\_/\
( -.- ) your quota, your turn
> ^ <
(")_(")
Self-contained installer (no .NET required), per-user, with a signed auto-update appcast.
Windows SmartScreen may warn because the .exe is unsigned → More info → Run anyway.
Or install with winget install Yovancas.ClaudeBarWin.
The OAuth token is only used to read your own usage — never stored, logged, or sent anywhere. No telemetry.
v0.3.7 — settings that fit your screen + true tray colors
ClaudeBar v0.3.7 — settings that fit your screen ⚙️
The settings panel used to be taller than the screen. Now it caps its height at ~65% of your
display and scrolls — with proper trackpad support. Plus the mascot settles into its best size.
Updating from 0.3.6? It installs itself — the app checks on launch, or right‑click → Check for updates.
⚙️ Settings panel: height cap + scroll
- The panel caps at ~65% of the working area and the content scrolls with the mouse wheel,
with a thin proportional scrollbar on the right. The header and "‹ Settings" stay pinned on top. - Trackpad-friendly: precision touchpads send smooth-scrolling (many tiny deltas instead of the
classic ±120 notch). Those used to be truncated to zero — the panel simply didn't scroll on
laptops. Now deltas accumulate losslessly: smooth, proportional scrolling on trackpads, and the
exact same 48px-per-notch feel on a classic mouse. - Detail work: scroll resets to the top every time you open settings, half-clipped rows don't react
to ghost clicks under the header, and when everything fits there's no bar and no scrolling at all.
🐱 Mascot: compact only
- The Large size is retired — the 4-line compact kitty is the definitive mascot. It reads just
as well, takes less space, and the dashboard breathes. - The setting goes from a 3-state control (Hidden · Compact · Large) to a simple Show mascot
toggle. Old configs with"MascotSize": "large"migrate silently (the key is just ignored).
🎨 Tray icon: true colors
- Fixed a bug that re-encoded the tray icon down to a 16-color VGA palette — green rendered as
teal and amber as olive. The badge now shows the theme's real colors (vivid green/amber/red),
in the tray and in every screenshot/GIF.
📖 README refresh
- The README (EN + ES) got a facelift: all screenshots and GIFs re-shot with the current UI,
including a new demo of the settings scroll and the tray icon color/shape cycle.
/\_/\
( ^.^ ) your quota, your turn
> ^ <
(")_(")
Self‑contained installer (no .NET required), per‑user, with a signed auto‑update appcast.
Windows SmartScreen may warn because the .exe is unsigned → More info → Run anyway.
The OAuth token is only used to read your own usage — never stored, logged, or sent anywhere. No telemetry.
v0.3.6 — loaf cat mascot + full README rewrite
ClaudeBar v0.3.6 — the mascot got a glow‑up 🍞🐱
The Large mascot has a brand‑new shape: a loaf cat, picked by a design jury from 12
candidates and inspired by the classics (oneko, Bongo Cat, kaomoji cats).
Updating from 0.3.5? It installs itself — the app checks on launch, or right‑click → Check for updates.
🐱 Mascot
- The rigid box is gone. The Large cat is now a cozy loaf: the compact kitty's head (ears,
face, whiskers) on a rounded body with(")_(")paws peeking underneath. Same family, way more
charming. - Animated tail — in live phases (working, waiting, compacting) the blink now comes with a
little tail flick. Idle and KO stay perfectly still, as a proper loaf should. - The body interior is intentionally empty so the phase color (green / amber / red / gray) makes
the outline pop at a glance.
/\_/\
( o.o )
> ^ <
/ \
( )
\_____/
(")_(")
📖 Docs
- README fully rewritten (EN + ES) — every feature explained and grouped with its screenshot
or GIF, a data‑flow diagram, a dedicated Live sessions & hooks section (with an honest "Is it
safe?"), an FAQ, and the recipe to rebuild the GIFs. - All screenshots/GIFs regenerated with the new mascot, plus a new strip showing the tray icon's
degraded states (stale data, error, colorblind‑safe shapes, amber attention dot).
Self‑contained installer (no .NET required), per‑user, with a signed auto‑update appcast.
Windows SmartScreen may warn because the .exe is unsigned → More info → Run anyway.
The OAuth token is only used to read your own usage — never stored, logged, or sent anywhere. No telemetry.
v0.3.5 — Settings redesign + the mascot is back
ClaudeBar v0.3.5 — settings redesign + the mascot is back
A focused polish pass over the UI: a minimalist one‑screen settings panel, the mascot finally
visible, and zero truncated text anywhere.
Updating from 0.3.4? It installs itself — the app checks on launch, or right‑click → Check for updates.
🐱 Key fixes
- The mascot is visible now. Turning on Show mascot used to do nothing unless Live Sessions
were enabled. Now an ambient idle cat shows up as soon as you enable it — and comes alive (blink,
spinner, verbs) when you turn Live Sessions on. - Zero cut‑off text. Every ellipsis that hid content is gone — subtitles, values and the pace
line now read in full (wrap or shorten, never truncate). - No duplicated info in the panel (the session quota was being drawn twice in the header).
⚙️ New settings panel (more Apple)
- Everything on one grouped screen — Panel content · Live sessions · Notifications · Frequency ·
Tray icon · Appearance · System · About — with clear headers, dividers and breathing room. - Pill toggles (more legible than checkboxes) and a single, consistent control language.
- Mascot as one 3‑state control: Hidden · Compact · Large.
- Live‑sessions master row in the positive (clear enable/disable, with confirmation).
- Better contrast and legibility across all three themes (Dark / Light / CLI).
🩹 Also
- Dashboard shows the mascot in its own band (no longer cramping the status), and per‑model usage
(Opus / Sonnet) gets a reference bar.
Self‑contained installer (no .NET required), per‑user, with a signed auto‑update appcast.
Windows SmartScreen may warn because the .exe is unsigned → More info → Run anyway.
The OAuth token is only used to read your own usage — never stored, logged, or sent anywhere. No telemetry.
v0.3.4 — Apple-style redesign (live sessions + microinteractions)
ClaudeBar v0.3.4 — the "Apple‑style" redesign
This is a big one. Since the last public build (0.2.0), ClaudeBar got a top‑to‑bottom redesign:
a coherent visual system, at‑a‑glance signals, a live‑session mascot, and now fluid
microinteractions across the whole panel.
Updating from 0.2.0? It installs itself — the app checks on launch, or right‑click → Check for updates.
✨ Microinteractions (new in this release)
- The panel fades in and its sections stagger into place.
- Numbers and bars tween to their target instead of snapping.
- Rows light up on hover; the mascot blinks, spins a braille spinner and shows a playful verb while it works.
- A quota reset gets a little celebration flash.
- Everything respects a Reduce motion toggle (Settings) if you want zero animation.
🐱 Live sessions + mascot
An ASCII mascot in the dashboard reacts in real time to your Claude Code sessions (idle / working /
waiting for approval / waiting for input / compacting / ended), driven by Claude Code hooks over a local
named pipe. Opt‑in from Settings → Live sessions (with a backup and a confirmation). The tray icon
adds an amber badge when a session needs your attention.
📊 At‑a‑glance signals + new look
- Pace marker and threshold ticks drawn inside the quota bar.
- Reset in local time ("resets in 1h 39m · Wed 04:18") + an explanation of the rolling 5h window.
- Stale‑data hint ("N min ago") and an honest privacy seal.
- Adaptive tray icon (light/dark taskbar) + status‑by‑shape (colour‑blind friendly).
- A coherent design system: 8pt grid, tabular digits, risk‑interpolated quota colour.
- An in‑dashboard ⚙ settings panel — all config in one place; the right‑click menu is now minimal.
🩹 Fixes
- The privacy seal and footer no longer truncate — they wrap and the panel grows to fit.
- Paint‑loop and layout stability (consistent measure/paint).
Self‑contained installer (no .NET required), per‑user, with a signed auto‑update appcast.
Windows SmartScreen may warn because the .exe is unsigned → More info → Run anyway.
The OAuth token is only used to read your own usage — never stored, logged, or sent anywhere. No telemetry.
v0.2.0 — Auto-actualización
ClaudeBar v0.2.0
Novedad principal: actualizaciones automáticas. A partir de esta versión ClaudeBar se actualiza
solo — comprueba al arrancar y te avisa, descarga e instala con un clic, verificando la firma.
Nuevo
- 🔄 Auto-actualización con verificación de firma e instalador (sin reemplazar el .exe a mano).
- 📊 Histórico de % real + pace/ETA: ritmo de consumo y si vas a agotar la cuota antes del reset.
- 📈 Gráfica de gasto por modelo integrada en el dashboard (Opus/Sonnet/Haiku), ventana móvil 1h→30d.
- 🎨 Temas Oscuro / Claro / CLI + importación de paletas
.itermcolors. - 🌍 9 idiomas (sistema + en/es/nl/fr/de/ja/ko/zh-Hant).
- 🔔 Notificaciones por hitos (25/50/75/95 %) + alertas de ritmo proactivas.
- 🩺 Estado del servicio de Claude en el dashboard.
- 💾 Caché offline: muestra la última cuota conocida sin conexión o con rate-limit.
Arreglos
- La etiqueta de "pico" ya no se solapa con el total/% en las gráficas.
- Varias mejoras de estabilidad del menú y el dashboard.
ClaudeBar for Windows v0.1.0
ClaudeBar for Windows — system-tray monitor for your Claude Code usage: real 5h/7d quota, pace prediction, usage charts, themes, and 9 languages.
Install
Download ClaudeBarWin.exe below and run it. Self-contained build — no .NET install required. The icon appears in the system tray (Windows 11: drag it out of the ^ overflow to pin it).
Windows SmartScreen may warn because the .exe is unsigned — choose More info → Run anyway.
Start with Windows: right-click the tray icon → Settings → Start with Windows.
Requirements
- Windows 10/11 (x64)
- Claude Code (CLI or app) installed and signed in — the app reads your local OAuth token to fetch your real quota.
Also installable via winget once the manifest is merged: winget install Yovancas.ClaudeBarWin.


