Display your Claude AI usage as a live progress bar on an Awtrix LED matrix - color-coded and always up to date.
What it does
Reads a Claude usage sensor (0-100%) from Home Assistant and pushes it to your Awtrix device via MQTT. The display shows the usage percentage alongside a progress bar, with text color that shifts from green → yellow → red as you approach your limits. Both thresholds are configurable.
The blueprint updates immediately whenever the sensor changes, and again on HA restart. If the sensor is unavailable, it gracefully falls back to an N/A state.
Tip: You can create this automation multiple times — for example once for weekly usage and once for session usage, each with its own app_name so both apps coexist in the Awtrix display rotation.
Prerequisites
- Home Assistant 2024.6 or newer
- Awtrix 3 with MQTT enabled
- MQTT broker (e.g. the Mosquitto add-on)
- A sensor exposing Claude usage as a percentage (0–100) — e.g. via hass-claude-usage
- A Claude icon installed on your Awtrix device (default icon ID:
74725)
Import
Or manually via Settings → Automations → Blueprints → Import Blueprint:
https://raw.githubusercontent.com/tnusch/ha-awtrix-claude-usage/main/blueprints/awtrix_claude_usage.yaml
Configuration options
| Parameter | Default | Description |
|---|---|---|
usage_sensor |
(required) | Sensor entity providing Claude usage (0–100%) |
awtrix |
(required) | Your Awtrix 3 device |
app_name |
claude_usage |
Unique MQTT app name — change this when running multiple instances |
icon_id |
74725 |
Awtrix icon ID for Claude |
suffix_text |
wk |
Suffix after the percentage — e.g. wk for weekly, se for session |
base_color |
DE7356 |
Hex color for text and progress bar (Claude brand color by default) |
threshold_warn |
50% |
Above this → yellow text |
threshold_high |
80% |
Above this → red text |
scroll_speed |
100% |
Scroll speed as percentage of original |
duration |
5s |
How long the app stays visible per rotation cycle |
text_case |
Global setting | Uppercase or as-entered |
push_icon |
Icon doesn't move | Icon scroll behavior |
Source
Full source and README on GitHub: tnusch/ha-awtrix-claude-usage
Feedback, issues, and PRs welcome!
