CLAUDE USAGE MONITOR / ESP32 APPLICATION
Clawdometer
Claude Code usage monitor on an e-ink desk gadget — rate-limit meters, live WORKING/NEEDS-YOU/QUESTION/DONE status, and a bell that rings when it's your turn. Waveshare ESP32-S3-ePaper-1.54, BLE.
About this project
About this project
Claude Code's own usage panel, mirrored onto a 1.54-inch 200×200 e-ink card that sits on the desk. A Python daemon on the Mac polls the API's rate-limit headers with the existing OAuth token, reads a status file written by Claude Code hooks, and pushes one small JSON payload over BLE every minute; the Waveshare ESP32-S3-ePaper-1.54 renders the 5-hour and weekly meters, a WORKING / NEEDS YOU / QUESTION / DONE banner, and per-day token stats. Each event has its own chime through the ES8311 codec. Nothing is soldered and nothing leaves the Mac. Sleep draws a small `zZ` and pulls about 20 µA, so a charge lasts roughly a week.
From the README
From the README
- Display
- 1.54-inch black/white 200×200 e-ink panel
- Dependency
- single-file Python daemon (bleak + httpx)
- Limit
- Run it from a real Terminal window
Hardware
Native board: Waveshare ESP32-S3-ePaper-1.54
Boards: ESP32-S3 Waveshare
ESP32-S3 / Waveshare. Verify the exact board revision, wiring and power requirements in the upstream build guide.
Media credit & rights
Upstream project media · rights remain with its owner · Credit: nsyll
Screenshots from the upstream README. Code and firmware were not executed. License notices are included.
View original source ↗ Copyright & removal · Reviewed
More projects on these boards
Waveshare AMOLED Watch jarvis reflbo Audi HUD Bisque Bus 404 Found
See what an ESP32 project looks like, and whether it runs on your board.
FILTERS
Browse by form factor. Check the exact board, chip and peripherals before installing.
Try a project
Newest listings
Give your project a little spotlight.
Repository links do not imply author endorsement or verified hardware compatibility. Check the upstream safety guidance before powering or flashing a build.