Repolode
Submit
HermannBjorgvin

HermannBjorgvin/Clawdmeter

An ESP32 desk display that shows your Claude Code usage limits, with an animated mascot that reacts to prompts and alerts you when a session needs input.

View on GitHub
Stars
2,270
Forks
386
Open issues
14
Last commit
20 hours ago

What is it?

Clawdmeter is a small desktop device built on ESP32 development boards that displays your Claude Code usage limits on a screen. A companion desktop app pairs with the board over Bluetooth and sends usage data to it, so the session and weekly meters stay visible while you work.

The on-device character, Clawd, reacts to prompts, cheers on activity, and shows an alert when a session needs your attention. Using the app's Hooks setup, the device can respond to Claude Code events. Usage meters work without hooks.

The project supports a wide range of boards from Waveshare, LILYGO, M5Stack, Seeed Studio and others, with display sizes from small TFT and e-paper panels to round AMOLED screens. The desktop app is available for macOS, Windows and Linux. Buttons on supported boards send key presses, so the device pairs as a Bluetooth keyboard.

Key features

  • 01Shows Claude Code session and weekly usage limits on a desk display.
  • 02Animated Clawd mascot reacts to prompts and cheers on activity.
  • 03Alerts when a Claude Code session needs your input, via Hooks setup.
  • 04Pairs with the desktop app over Bluetooth; buttons appear as a keyboard.
  • 05Desktop app for macOS, Windows, and Linux, with Nix flake support.

Use cases

  • Keeping an eye on Claude Code usage limits without opening a browser or terminal.
  • Getting a physical alert when a Claude Code session is waiting for your answer.
  • Building a custom desk gadget on a supported ESP32 display board.

Quick start

  1. 1

    Download the app from the latest release page

  2. 2

    Launch Clawdmeter, follow setup, connect the board with a USB data cable and install firmware

  3. 3

    Pair Clawdmeter in your computer's Bluetooth settings

  4. 4

    Optionally open Hooks to let Clawd react to Claude Code activity

Things to know

  • Requires one of the supported ESP32 boards, so you must buy compatible hardware.
  • macOS and Windows packages are not signed with a publisher certificate, so the OS may block them.
  • The repository includes Anthropic proprietary fonts and copyrighted Clawd assets, so forking or reusing the code carries legal risk.

Topics

#esp32#claude-code#hardware#bluetooth#embedded#desk-display#iot#claude#freenove#lilygo

FAQ

What is Clawdmeter?
An ESP32 desk display that shows your Claude Code usage limits, with an animated mascot that reacts to prompts and alerts you when a session needs input. Clawdmeter is a small desktop device built on ESP32 development boards that displays your Claude Code usage limits on a screen. A companion desktop app pairs with the board over Bluetooth and sends usage data to it, so the session and weekly meters stay visible while you work.
Is Clawdmeter free to use? What license does it have?
Clawdmeter has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is Clawdmeter still maintained?
Actively maintained. The last commit to Clawdmeter was on Oct 19, 2026.
What can I use Clawdmeter for?
Keeping an eye on Claude Code usage limits without opening a browser or terminal. Getting a physical alert when a Claude Code session is waiting for your answer. Building a custom desk gadget on a supported ESP32 display board.
How do I install Clawdmeter?
Download the app from the latest release page Launch Clawdmeter, follow setup, connect the board with a USB data cable and install firmware Pair Clawdmeter in your computer's Bluetooth settings Optionally open Hooks to let Clawd react to Claude Code activity
Where can I get Clawdmeter?
The source code and installation instructions are on GitHub: https://github.com/HermannBjorgvin/Clawdmeter

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects