Skip to content

v0.0.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 29 Jun 18:48
v0.0.1
e138d17
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

First public release of Clawdmeter — Claude usage monitoring for Home Assistant.

Clawdmeter polls Anthropic's OAuth usage API and turns it into a full set of Home Assistant sensors, including computed metrics the API doesn't give you: live burn rate, time-to-limit, and a colour-coded "runway" verdict.

Features

  • Usage & limits — session, weekly, Sonnet and Opus usage with reset timestamps and a live "resets in" countdown.
  • Burn rate — 5-minute and 30-minute rates in %/h, plus a per-minute usage rate.
  • Projection — time-to-limit and a session limit ETA.
  • Runway — a pace ratio, a signed margin, and a "limit reached before reset" alert.
  • Mood — pace frame (green/orange/red) and animation group (idle → heavy) to drive a dashboard accent or the ESPHome creature.
  • Extra usage / overage — credits, limit and percentage (legacy and new spend API).
  • Multi-account — run a Pro and a Max account side by side; each gets its own device.
  • English & German UI, with a configurable poll interval (60–3600 s, default 300).

Setup

  • Install via HACS (custom repository, category Integration) or copy custom_components/clawdmeter into config/custom_components/ manually, then restart Home Assistant.
  • Add it under Settings → Devices & Services → Add Integration → Clawdmeter and authenticate over OAuth — there is no API key, you just paste the code Anthropic shows you.

Requires Home Assistant 2026.6.0 or newer.

See the README for the full entity list, idle-state behaviour and screenshots.

Assets 3
Loading