Claude Usage

Shows your Claude plan usage on an AWTRIX NG TC002 (52x16). Use one automation per limit, for example the 5-hour session and the weekly limit.

Each app shows an icon, a label, the usage percentage and the time left until the reset, with a progress bar along the bottom. The percentage and bar turn yellow and then red as usage crosses two thresholds you choose. When a reset time sensor is set, the time left refreshes every minute.

1. Install the Claude Usage integration (github.com/trickv/hass-claude-usage). It provides the usage sensors (session and week, in %) and the reset time sensors.

2. Upload a 16x16 icon to the clock and enter its ID in the blueprint (default: claude). AWTRIX NG refuses the update when the icon is missing. Leave the field empty for a text-only layout.

3. Import the blueprint and create two automations:

   Session

   • Usage sensor: Session usage
   • Reset sensor: Session reset time
   • Label: Session
   • App name: claude_session_usage

   Week

   • Usage sensor: Week usage
   • Reset sensor: Weekly reset time
   • Label: Week
   • App name: claude_week_usage

4. Adjust the thresholds, colors and time-left language as needed.

Community blueprint, not affiliated with Anthropic.