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

v1.2.0 — Compact mode & MCP-aware moods

Compact floating mode, a new mascot mood for MCP tools, and the project's
first contributor guide — with thanks to two first-time community
contributors. 🎉

✨ New features

• Compact mini-mode widget — a tiny, always-on-top floating readout
  (mascot + session/weekly usage with live reset countdowns). Hit the new
  compact button in the title bar to shrink down; double-click or
  right-click → Expand to return. Draggable, and its position is
  remembered between sessions. Thanks to @ghz! (#1)
• MCP-aware INTEGRATING mood — when Claude Code reaches out through an
  MCP server tool, the mascot now shows a dedicated INTEGRATING mood with
  the server in the label (e.g. INTEGRATING — github/list_issues). Also
  broadens tool recognition and gives PLANNING its own animation (it
  previously shared one with SEARCHING). Thanks to @sherifscript! (#2)

🔧 Improvements

• The compact widget's reset times now use the same relative
  "resets in 4h 56m" format as the main window, ticking down live in lockstep.
• Added a Contributing section to the README — issue-first for larger
  changes, the Anthropic sprite carve-out, dependency expectations, and an
  open-to-discussion note on cross-platform.

🙌 Contributors

Big thanks to first-time contributors @ghz and @sherifscript for the
features in this release!

⬇️ Download

Grab Clawdmeter.exe below — a single self-contained file, no install needed.

The exe isn't code-signed, so Windows SmartScreen may warn on first run
("unknown publisher"). Click More info → Run anyway, or
run from source / build it yourself.

SHA-256: B6B39AB4C3008ABCB2194B36C1984125A6DD448A0508E931AF76AFD0049C9609

Full changelog: v1.1.1...v1.2.0

Clawdmeter-Windows v1.1.1

A small polish release.

Changed

• The system-tray hover tooltip now refreshes live — session/weekly usage
  and the reset countdowns update every second instead of every ~60s, so the
  readout is accurate the moment you hover. (The tooltip itself isn't new; this
  just keeps it current.)

Download

Grab Clawdmeter.exe below — single self-contained file, no install. (Unsigned,
so SmartScreen may warn on first run → More info → Run anyway.)

Software-only Windows port of
Clawdmeter by HermannBjorgvin —
credit to them for the original concept. The Clawd mascot is © Anthropic PBC
(pixel art from claudepix.vercel.app). Unofficial, not affiliated with Anthropic.

Clawdmeter-Windows v1.1.0

First feature update since v1.0.0 — focused on keeping the dashboard alive and tidying the app.

New

• Token auto-refresh — Claude's OAuth access token expires ~every 8 hours, which used to blank the dashboard. The app now refreshes it automatically so the numbers stay live unattended. Toggle it off, or refresh manually, in Settings → Token (the manual button is enabled only when the token is actually expired).
• Single-instance — relaunching now surfaces the existing window instead of stacking up tray processes.
• Quit on close — optional setting to make the window's ✕ fully exit instead of minimizing to the tray.
• Scrollable settings panel + an About section.

Changed

• Built on PySide6 6.11 / Python 3.14.

Download

Grab Clawdmeter.exe below — single self-contained file, no install. (Unsigned, so SmartScreen may warn on first run → More info → Run anyway.)

Software-only Windows port of Clawdmeter. Code MIT-licensed; the Clawd mascot is © Anthropic PBC. Unofficial, not affiliated with Anthropic.

Clawdmeter-Windows v1.0.0 — first public release

First public release of Clawdmeter-Windows — a standalone Windows desktop
dashboard for Claude Code usage. The same metrics as
Clawdmeter, software-only, no
ESP32 hardware.

Download

Grab Clawdmeter.exe from the Assets below — a single self-contained file.
No Python, no install, no dependencies. Just download and run.

⚠️ The exe isn't code-signed, so Windows SmartScreen may warn "Windows
protected your PC / unknown publisher" on first run. Click
More info → Run anyway. Prefer to build it yourself? See the
README.

What it does

• Session (5h) and Weekly (7d) usage %, each with a reset countdown
• A Clawd mascot that reacts in real time to what Claude Code is doing —
  coding, reading, searching, planning — and falls back to a usage-rate mood
  (sleepy → dancing) when idle
• A system-tray icon whose fill arc tracks session %
• Settings panel: alternative credentials path, always-on-top, auto-hide title
  bar, Start-menu shortcut

How it works

Reads your Claude Code OAuth token from ~/.claude/.credentials.json, sends a
minimal 1-token request to api.anthropic.com/v1/messages every 60s, and reads
the rate-limit headers. Your token never leaves your machine except in that
request to Anthropic's API.

Requirements

• Windows 10 or 11 (64-bit)
• An active Claude Code login (~/.claude/.credentials.json)

Credits & license

Software-only port of HermannBjorgvin/Clawdmeter.
Code is MIT-licensed; the Clawd mascot artwork is © Anthropic PBC — see
NOTICE.
Unofficial project, not affiliated with Anthropic.