v3.0.1 — token counts corrected (~2.5x lower)

Your token and value numbers will drop by roughly 2.5×. That is the fix, not a regression.

Clawdmeter was counting each assistant message once per content block. Claude Code writes one
message as several JSONL records — one for the thinking, one for the text, one per tool call —
and each repeats the same usage figures. Everything read from your transcripts was multiplied by
however many blocks a message happened to have.

Your percentage bars and extra-usage spend were never affected — those come from Anthropic's
rate-limit headers and usage endpoint, not from transcripts. Only the token counts under the
bars, the per-session totals and the Stats page were wrong.

Downloads

Platform	File	How to run it
Windows	Clawdmeter.exe	Single self-contained file — just run it.
macOS	Clawdmeter.dmg	Open, drag to Applications. Universal — one download for Apple Silicon and Intel.
macOS (zip)	Clawdmeter-macos.zip	The same .app, if you'd rather not mount a disk image.
Linux	Clawdmeter-3.0.1-x86_64.AppImage	chmod +x and run. One file, no install; delete it to uninstall.
Linux (tarball)	Clawdmeter-3.0.1-linux-x86_64.tar.gz	Unpack, run ./install.sh — adds a menu entry.

Every file has a .sha256 beside it. Full checksums:

879615136889f8436c48398005e8a4ea5a5d120eaaa79116b1b945e878761aaa  Clawdmeter.exe
624de40071661358eb36dbdf20d578bd16eb95c18a574e6d11e2611ecacbaf7b  Clawdmeter.dmg
cd9b779ac6e57b71ae112d025d149b471f6e4713f7344d10bd00e0760fbc7fbd  Clawdmeter-macos.zip
ee5bdf383efd77688c66185b8805edb6a8429702618ac93cd182387594200e9d  Clawdmeter-3.0.1-x86_64.AppImage
2ee59c25ab5efcdf18b789fc9370b5d0abb00c4ab4b8ae9c017eb87d571474b7  Clawdmeter-3.0.1-linux-x86_64.tar.gz

Verify with sha256sum -c <file>.sha256 on Linux, shasum -a 256 <file> on macOS, or Get-FileHash <file> on Windows.

None of these are code-signed yet, so each OS will question them once.

• Windows — SmartScreen → More info → Run anyway.
• macOS — Gatekeeper says "Apple could not verify Clawdmeter is free of malware." Try to open it, then go to System Settings → Privacy & Security → Security and click Open Anyway. Right-click → Open no longer works on macOS 15 (Sequoia) or later — Apple removed that bypass.
• Linux — no prompt.

Fixed

Token usage was counted per JSONL record instead of per message (#21). One assistant message is
written as several records — one per content block — each repeating the same message.id and the
same usage figures. Summing them counted every message once per block.

Measured across a real 18,654-message corpus: 73% of messages landed on more than one record, and
work tokens read 2.575× high. Reproduced on Windows, Linux and macOS transcripts — the reader
has no platform-specific paths, and the duplication is written by Claude Code itself, so every
install was affected identically, on every version before this one.

Two separate duplications are now resolved across the whole scan rather than per file: a message
split across several records, and a resumed session replaying those records into a second
transcript file. Records of one message are folded by taking the largest figure per bucket, because
output_tokens is a running total — early records carry a partial count — and a replayed copy can
carry an all-zero usage block.

What this changes on screen: the token counts beside the 5h/7d bars, the per-session totals on the
shelf, and everything the Stats page prices, including API value this month, lifetime value,
cache savings, value by model and project, and the turn count.

Finished the repo rename. The project moved to github.com/weltern/Clawdmeter on 2026-08-03,
but four files outside src/ still carried the old name — including the Windows version resource
you see in the exe's Properties dialog, and the AppStream metadata. The old URL only redirects, so
nothing was broken; it was just wrong.

Requirements

Windows 10/11 · macOS 13+ · Linux with glibc 2.35+ (Ubuntu 22.04+, Debian 12+, Fedora 36+)

Thanks

To @lizhuojunx86, who found the token-counting bug, measured it against a ~50-day corpus, and
filed #21 with a self-contained reproduction. The report was accurate, the diagnosis was right, and
the writeup made it straightforward to confirm independently and fix properly.

v3.0.0 — Windows, macOS & Linux

Clawdmeter is now a cross-platform desktop app — Windows, macOS and Linux, one codebase, no reduced edition anywhere.

Downloads

Platform	File	How to run it
Windows	Clawdmeter.exe	Single self-contained file — just run it.
macOS	Clawdmeter.dmg	Open, drag to Applications. Universal — one download for Apple Silicon and Intel.
macOS (zip)	Clawdmeter-macos.zip	The same .app, if you'd rather not mount a disk image.
Linux	Clawdmeter-3.0.0-x86_64.AppImage	chmod +x and run. One file, no install; delete it to uninstall.
Linux (tarball)	Clawdmeter-3.0.0-linux-x86_64.tar.gz	Unpack, run ./install.sh — adds a menu entry.

Every file has a .sha256 beside it. Full checksums:

43ff4b957d8d0275e18eb7676644165fcd12b242696f2cf0e34fd8f28758fbab  Clawdmeter.exe
70a460050a8f55493ba6e21ff21c0531d5e90816d3a623b3dd14c34787da29ed  Clawdmeter.dmg
c58bbee5f061ddcfbdf97f3ad659011d695d7bc12f77b0f81ea44a4865d1e884  Clawdmeter-macos.zip
fd2597018b0cd12c1b217926867c5f095e38636dacee29136c4f676a1d806aae  Clawdmeter-3.0.0-x86_64.AppImage
bea83d3b30ea547f0645d1efebd92a813add923270026e1545eb665d37c05c85  Clawdmeter-3.0.0-linux-x86_64.tar.gz

Verify with sha256sum -c <file>.sha256 on Linux, shasum -a 256 <file> on macOS, or Get-FileHash <file> on Windows.

None of these are code-signed yet, so each OS will question them once. Windows: SmartScreen → More info → Run anyway. macOS: right-click the app → Open → Open. Linux: no prompt.

New

macOS and Linux support. macOS gets a native transparent-titlebar window with real traffic lights and a menu-bar item. Linux runs on X11 and Wayland, with the tray via AppIndicator/KStatusNotifierItem.

Themes. 16 presets (nine dark, seven light), a follow-your-system mode with separate light/dark targets, and a custom theme editor over eight base roles — on-screen eyedropper, live per-role contrast ratios, a WCAG-AA "Fix contrast" button, and import/export.

Requirements

Windows 10/11 · macOS 13+ · Linux with glibc 2.35+ (Ubuntu 22.04+, Debian 12+, Fedora 36+)

Thanks

To @c0dezer019 — his Linux packaging work in #3 shaped the AppImage that ships here, including the AppDir layout and the choice of tooling that spares users the usual FUSE problem.

To @AbdulkadirCELEBI — #19 flagged the missing per-model Usage windows card on the Stats page and the platform guards needed off Windows. Both are in this release.

v2.4.1 — fix false limit-reset alert

Bug-fix release. No user-facing features.

Fix

• False "limit reset" + repeat "approaching limit" alert (#17) — a usage-probe response that failed (401 expired token, 429 once a window is fully capped) was being read as a genuine 0% usage sample instead of a failed probe, firing a false reset alert followed by a false re-approach alert once real data resumed. The probe now checks the HTTP response status before parsing it.
• Confirmed against 22.5 days of local usage history: the false-zero state accounted for ~124.5h (weekly) / ~103.8h (session) of incorrect readings that didn't align with any real reset.

Tests

213 pass, including a new regression test for the fixed code path.

Verification

sha256 (also in Clawdmeter.exe.sha256):

8a93938e3a15934d89a2088b6bd59941c6b7f7f9b0097021e57d2db168107313  Clawdmeter.exe

v2.4.0 — Startup, limit alerts & idle back-off

What's new

• Start with Windows — Clawdmeter can now launch automatically when you sign in, coming up quietly in the system tray. Toggle it in Settings → General → Startup (off by default).
• Approaching-limit & overage alerts — get a heads-up before you run out, not just when a limit resets. Set separate warning thresholds for the 5h session and 7d week (defaults 90% / 80%), and optionally get pinged the moment you cross 100% into paid overage. Settings → Notifications → "When approaching a limit." Uses the same toast/push channels as the reset alert.
• Slow polling when idle — opt-in option to ease off on usage checks when no Claude Code session has been active for a while, then snap back when you return. Settings → Connection.
• Themed update notifications — the "update available" popup now matches the app's look (mascot card) instead of the native Windows toast; click it to open the download page.
• Polish — themed the settings inputs and gave the threshold a slider + editable value.

Download

Grab Clawdmeter.exe below — single self-contained file (~29 MB), no install. The exe isn't code-signed, so Windows SmartScreen may warn on first run: More info → Run anyway.

Verify

b9b5c98f19120c9fd44a193559b2605db15bc0c36a2e8b87c528bd6c3c93a4b5 Clawdmeter.exe

v2.3.0 — Stats page, nav rail & more

The biggest release yet — a full Stats page, a slim navigation rail, a tabbed Settings page, multi-channel push notifications, and in-app update checks. This rolls up everything since v2.0.1.

✨ Stats page

A new page (the chart icon in the nav rail) that turns the usage you've already racked up into a picture of what your subscription is actually worth — all computed locally from your transcripts priced against a bundled rate card, enriched with Anthropic's OAuth usage endpoint for real spend and plan. Every visual is hand-drawn, so it adds nothing to the download size.

• API value this month vs your plan price (e.g. "≈ 33× your subscription"), with lifetime value and the break-even day
• Extra usage (real pay-as-you-go spend) and cache savings + cache hit rate
• Time to 7-day cap — a burn-rate estimate from your recent usage
• Value by model, value by project, and code by language (the languages of the files Claude edits)
• Activity mix (coding / reading / planning / …), this week vs last, current streak, and sessions
• A per-day value strip, a 7×24 activity heatmap, and a monthly recap

🧭 Navigation rail

A slim, icon-only rail down the left edge — switch between Dashboard, Stats, and Settings, with the mascot pinned at the top. (Replaces the old title-bar gear.)

⚙️ Settings, retabbed

Settings is now a full page split into General · Display · Connection · Notifications · About tabs, each scrolling on its own.

🔔 Notifications — more channels

Limit-reset alerts can now reach you off this machine through ntfy, Telegram, Discord, Slack, Pushover, Gotify, or a generic webhook — add several and every one fires. The Windows toast (with optional sound / pop-to-front) is its own channel.

⬆️ In-app update checks

The app now checks GitHub Releases (about once a day) and surfaces an Update available item in the tray plus a toast when a newer build is out — click it to open the download page. Toggle it under Settings → General → Updates.

🩹 Under the hood

• OAuth usage/profile polling for plan tier + extra-usage spend, and a persisted usage history that powers the burn-rate and trends
• Bundled USD price map with an auto-updating rate card
• UI icons migrated to bundled Font Awesome
• A round of code-review hardening — threading, window-resize, lifetime-scan efficiency, and safer token-refresh + update-URL handling
• Usage polling is unchanged: the same minimal ~1-token probe. Everything new in Stats is computed locally, so there's no extra API token cost

📥 Install

Download Clawdmeter.exe below — a single self-contained file (~29 MB, bundling Python + Qt), no install needed. The exe is unsigned, so Windows SmartScreen may warn on first run: More info → Run anyway.

SHA-256 (Clawdmeter.exe):

2e978ff33d99ac319e89d1dda252f066644961bd19e640381a88706f8c2611b4  Clawdmeter.exe

Verify before running: Get-FileHash Clawdmeter.exe -Algorithm SHA256

v2.0.1 — Per-window overage (5h + 7d)

Clawdmeter-Windows 2.0.1

A focused follow-up to 2.0.0: overage is now truthful and per-window.

Changed

• Overage shows on both the Session (5h) and Weekly (7d) bars — derived from each window crossing 100%, not a separate overage field. When a window goes over, its bar empties and restarts in red (filling from the left by the amount past 100%), the percentage keeps climbing (e.g. 120%), and a red OVERAGE tag joins the title. Consistent across the full, compact, and mini views.
• Dropped the standalone overage signal that never fired on accounts with uncapped extra usage — the true signal is the window itself going past 100%.

Download

Grab Clawdmeter.exe below — a single self-contained file (~29 MB), no install needed. It isn't code-signed, so Windows SmartScreen may prompt the first time: More info → Run anyway.

---

Merges #10 · Full changelog: v2.0.0...v2.0.1

v2.0.0 — Token usage, overage & view modes

Clawdmeter-Windows 2.0.0

New

• Token usage — input + output token totals beside the bars (5h / 7d), a full per-session breakdown on mascot hover, and a line in the tray tooltip. Read from your local transcripts (no extra API calls); toggle under Settings → Token usage.
• Weekly overage — go past 100% onto usage credits and the weekly bar shows a red overflow past 100% (20% over → 120%) with an OVERAGE tag. Self-hiding, weekly-only.
• Compact view — a new slim, always-on-top list with one row per session (mascot, title, tokens, activity + target). Joins the full dashboard and the renamed mini chip for three view modes; your last mode is remembered across launches.
• Activity targets — the line under each mascot shows what Claude Code is working on (file / pattern / command / host), not just the tool name.
• Truthful "last active" — idle timing now comes from the session's own last transcript event, not the clock at read-time.
• Scrolling titles — long session titles scroll on hover.

Download

Grab Clawdmeter.exe below — a single self-contained file (~29 MB), no install needed. It isn't code-signed, so Windows SmartScreen may prompt the first time: More info → Run anyway.

---

Merges #9 · Full changelog: v1.3.1...v2.0.0

v1.3.1 — High-DPI & other fixes

Bug-fix release: high-DPI and multi-monitor window behavior on Windows.

🐛 Fixes

• Resize cursor no longer covers the whole window at 200% scaling (#7). The frameless window's resize hit-test compared physical-pixel mouse coordinates against Qt's device-independent geometry, so at high DPI most of the client area read as a resize border. It now hit-tests with logical cursor coordinates (and rejects out-of-bounds points), so the resize cursor appears only near the actual edges.
• Compact view no longer explodes when dragged between monitors of different scaling. Dragging the compact widget from a 100% to a 200% monitor ballooned it across the desktop. Dragging now hands off to Windows' native, DPI-aware move loop (with a size cap as a backstop), so it keeps its normal size. Double-click-to-expand and the context menu still work.
• Main window no longer explodes when dragged across monitors. The title-bar drag had the same root cause and got the same native-move fix; double-click-to-maximize is preserved.
• Compact reset text is no longer clipped at high DPI. The trailing character of strings like "resets in 2h 20m" / "resets in 4d 06h" could be cut off at the right edge; the compact window is now sized with a little horizontal slack so the text always renders in full.

⬇️ Download

Clawdmeter.exe — one-file build (~29 MB), attached below. No install needed; it runs to the system tray.

v1.3.0 — Limit-reset notifications

Know the moment a Claude usage limit resets so you can get back to work.

✨ New: limit-reset notifications

• Smart, gated alerts — fire only when it matters: you were near/at the limit, or being throttled, just before the reset. Session (5h) and weekly (7d) limits are tracked independently, so a 5h throttle can't trip a false weekly alert.
• Custom in-app toast — a themed pop-up with an animated mascot in the bottom-right, replacing the generic OS notification. Click it to jump back to the dashboard; it shows even when minimized to the tray.
• Optional sound and pop-to-front on reset.
• Phone push — get pinged on your phone via ntfy (no account needed, just pick a topic) or Telegram (bot token + chat ID). A "Send test notification" button in Settings verifies your setup.

🎨 UI polish

• Compact widget is now fully opaque with a clay accent border and ~10% larger for readability.

📦 Install

Download Clawdmeter.exe below and run it — single file, no installer (~29 MB, Windows x64).

🙏 Credits

Core notification feature by @sherifscript (originally #5), carried forward and built on for this release.

---

Merged in #6.

v1.2.1 — Leaner build

A maintenance release focused on download size, plus one small visual fix.

📦 Smaller download: ~48 MB → ~27 MB (−44%)

The one-file build was bundling a large amount of PySide6/Qt that the app never
uses. The PyInstaller spec now prunes it:

• Removed Qt''s ~20 MB software-OpenGL fallback (opengl32sw.dll) — unneeded for a Widgets UI
• Removed the QML/Quick/Pdf/Svg/OpenGL Qt modules — the app only uses Core/Gui/Widgets/Network
• Removed a duplicate OpenSSL that was being pulled in by accident from the build PATH
• Removed unused image-format & platform plugins and Qt''s bundled translations (the app ships English-only and loads no translator)

The remaining weight is just the Python runtime + the Qt modules actually in use.

🪟 Compact view

The compact (mini) widget now has a solid background matching the main window.
It had quietly been using a translucent background ever since it was introduced —
that relied on the software-OpenGL fallback removed above, so it's now opaque and
renders correctly in the slimmed build.

Notes

• The exe is not code-signed — Windows SmartScreen may warn on first run; click
  More info → Run anyway. Prefer to build it yourself? See the README.
• Settings and saved tokens from v1.2.0 carry over unchanged.

Full changelog: v1.2.0...v1.2.1