Neura Market
HermannBjorgvin/Clawdmeter logo

HermannBjorgvin/Clawdmeter

Free

ESP32 desk dashboard that shows Claude Code usage

FreeFree tier
Type
Open Source
Visit Website GitHub (38 stars)

About HermannBjorgvin/Clawdmeter

Clawdmeter is an open-source ESP32-based desk dashboard designed to monitor Claude Code usage in real time. It runs on supported Waveshare ESP32-S3 and ESP32-C6 boards (AMOLED and LCD variants), pairs over Bluetooth Low Energy, and displays pixel-art Clawd animations that become progressively busier as usage rate increases. The device features a touch screen that toggles between a splash screen (with animated Clawd sprites) and a usage meter view. Two side buttons send Space and Shift+Tab via BLE HID, providing quick access to Claude Code's voice mode and mode-toggle shortcuts. The firmware auto-rotates animations every 20 seconds within the current usage-rate group. A long press of the power button enters pairing mode. The project is hosted on GitHub and provides installation scripts for macOS, Linux, and Windows, requiring PlatformIO CLI and an active Claude Code subscription. It is fully open source, with a modular HAL design that allows porting to additional boards.

Key Features

Real-time Claude Code usage monitoring displayed on an ESP32 dashboard
Bluetooth Low Energy (BLE) connectivity for pairing with host device
Touch screen toggles between splash animation and usage meter view
Two side buttons send Space and Shift+Tab over BLE HID for voice mode and mode-toggle shortcuts
Pixel-art Clawd animations that increase in activity based on usage rate
Auto-rotation of splash animations every 20 seconds within current usage-rate group
Long press power button (3s) initiates pairing mode and clears Bluetooth bond
Supports multiple Waveshare boards: ESP32-S3/C6 Touch AMOLED 1.8", 2.06", 2.16", and LCD 1.54"
Open-source firmware with modular HAL for easy porting to other boards
Installation scripts for macOS, Linux, and Windows (PlatformIO CLI required)

Pros & Cons

Pros
  • Open source and fully customizable firmware and hardware design
  • Engaging pixel-art animations provide at-a-glance usage feedback
  • BLE HID buttons offer convenient shortcuts for Claude Code interactions
  • Works out of the box with several popular Waveshare ESP32 boards
  • Modular HAL simplifies porting to additional ESP32-based hardware
  • Installation scripts available for all major desktop platforms
Cons
  • Requires purchasing a compatible Waveshare ESP32 board and enclosure
  • Needs an active Claude Code subscription to be useful
  • Setup involves flashing firmware and configuring Bluetooth pairing, which may be technical for non-developers
  • Limited to supported board list; porting to other hardware requires development effort
  • Only displays Claude Code usage; no support for other LLM tools or general metrics

Best For

Monitoring Claude Code API usage from a physical desk accessoryQuickly accessing Claude Code voice mode and mode-toggle shortcuts without keyboardAdding a visual, ambient indicator of Claude Code activity to a developer workspaceExperimenting with ESP32 hardware and BLE HID prototyping

FAQ

What hardware boards are supported?
Waveshare ESP32-S3-Touch-AMOLED-2.16, ESP32-C6-Touch-AMOLED-2.16, ESP32-S3-Touch-AMOLED-1.8, ESP32-C6-Touch-AMOLED-1.8, ESP32-S3-Touch-AMOLED-2.06, and ESP32-S3-Touch-LCD-1.54 (240x240 SPI TFT).
How do I pair the device with my computer?
After flashing the firmware, open System Settings → Bluetooth and click Connect next to 'Clawdmeter'. To force pairing mode, hold the power button for 3 seconds then release to clear the saved Bluetooth bond and re-advertise.
What do the side buttons do?
The left button sends Space (used for Claude Code voice mode) and the right button sends Shift+Tab (used for mode toggle).
Do I need a Claude Code subscription?
Yes, Claude Code with an active subscription is required for the dashboard to display usage data.
Can I add support for a different ESP32 board?
Yes, the firmware uses a thin HAL with per-board folders under firmware/src/boards/. You can add a new board folder and PlatformIO environment; main.cpp, ui.cpp, and splash.cpp never need to change. See docs/porting/adding-a-board.md for instructions.
Is the project open source?
Yes, Clawdmeter is hosted on GitHub under the repository HermannBjorgvin/Clawdmeter and is open source.