HermannBjorgvin/Clawdmeter

ESP32 desk dashboard that shows Claude Code usage

What it solves

Clawdmeter is a physical desk dashboard for monitoring Claude Code usage and rate limits. It provides a real-time visual indicator of session and weekly utilization, reducing the need to check usage stats manually within the software.

How it works

  • Data Retrieval: A background daemon (Python) runs on the host machine (macOS, Linux, or Windows), reads the user's Claude OAuth token, and polls the Anthropic API for usage headers.
  • Communication: The daemon pushes usage data to an ESP32-based device over Bluetooth Low Energy (BLE).
  • Display: The firmware (C++/LVGL) parses the JSON payload and updates an AMOLED screen with usage percentages and reset timers.
  • Visuals: The device features pixel-art animations of the mascot "Clawd" that change based on the usage rate.
  • Control: The device acts as a BLE HID keyboard, allowing users to send shortcuts (Space for voice-mode and Shift+Tab for mode-toggle) directly to the host machine.

Who it’s for

Developers and power users of Claude Code who want a dedicated hardware monitor for their AI usage limits and a physical shortcut controller.

Highlights

  • Multi-platform Support: Dedicated installers for macOS, Linux, and Windows.
  • Hardware Flexibility: Supports multiple Waveshare ESP32-S3/C6 AMOLED boards out of the box.
  • Interactive Animations: Usage-rate-dependent animations and attention alerts that notify the user when Claude Code is waiting for input.
  • HID Integration: Physical buttons for push-to-talk and mode switching.
  • Customizable: Includes a desktop simulator for UI iteration and tools for converting assets into C arrays.

Related

  • Project
  • Project
  • Project
  • Project
  • Project