Clawdmeter: A Physical ESP32 Dashboard That Shows Your Real-Time Claude Code Usage
文章目录
- Real-Time Claude Code Metrics — Clawdmeter runs a lightweight daemon on your host machine that intercepts Claude Code API calls and extracts usage data. The ESP32 polls this daemon over USB/WiFi and renders beautiful usage dashboards on the TFT display, including conversation history, token consumption, and cost estimates. Hardware Flexibility — The project started with the Waveshare ESP32-S3-TFT 2.8" board, but the community has rapidly expanded support to include the smaller 1.8" AMOLED boards (SH8601 driver) and multiple ESP32-S3 variants. The UI adapts dynamically to different screen sizes. Cross-Platform Daemon — Originally Linux-focused, the project now supports macOS hosts (verified with TechCrunch's expedited integration) and is working toward Windows support. The daemon runs as a background service and exposes a simple JSON API that the ESP32 queries at regular intervals.
-
- A community contributor, @lorddavidson, submitted a PR adding macOS host support and a port to the Waveshare 1.8" AMOLED board. The maintainer was enthusiastic: "Hey @lorddavidson I had TechCrunch reach out about the project so I expedited the macOS support and cherry-picked parts from your branch. I credited you in the macOS instructions in the README." The contributor responded graciously and committed to fixing remaining 1.8" display issues over the weekend. The PR also included a refactored UI layout system with ui_layout.h split for better hardware portability.
- The 1.8" Waveshare ESP32-S3 board with SH8601 display driver was being ported, with questions about FT3168 touch controller support. The community discussion focused on whether the existing touch driver could handle the different touch controller or if custom calibration was needed for the smaller screen size.
- Clawdmeter is a brilliant intersection of embedded hardware and AI tooling observability. With TechCrunch coverage, active open-source contributions, and a clear expansion roadmap (more boards, more platforms), it's an excellent example of how the AI developer community is building physical feedback tools around LLM usage. If you're a heavy Claude Code user and want a tangible way to track your usage patterns, this is a weekend project worth building.
Clawdmeter is an open-source ESP32-based desk dashboard that displays your real-time Claude Code usage directly on a compact screen sitting on your desk. Built with the Waveshare ESP32-S3-TFT board (featuring a 2.8" 320x240 display with touch support), it connects to Claude Code running on your host machine via a local daemon and shows live metrics like conversation counts, token usage, and project statistics. The project has gained significant traction since launch, even catching the attention of TechCrunch, and is rapidly expanding to support more hardware variants and platforms.
- Real-Time Claude Code Metrics — Clawdmeter runs a lightweight daemon on your host machine that intercepts Claude Code API calls and extracts usage data. The ESP32 polls this daemon over USB/WiFi and renders beautiful usage dashboards on the TFT display, including conversation history, token consumption, and cost estimates.
- Hardware Flexibility — The project started with the Waveshare ESP32-S3-TFT 2.8" board, but the community has rapidly expanded support to include the smaller 1.8" AMOLED boards (SH8601 driver) and multiple ESP32-S3 variants. The UI adapts dynamically to different screen sizes.
- Cross-Platform Daemon — Originally Linux-focused, the project now supports macOS hosts (verified with TechCrunch's expedited integration) and is working toward Windows support. The daemon runs as a background service and exposes a simple JSON API that the ESP32 queries at regular intervals.
A community contributor, @lorddavidson, submitted a PR adding macOS host support and a port to the Waveshare 1.8" AMOLED board. The maintainer was enthusiastic:
"Hey @lorddavidson I had TechCrunch reach out about the project so I expedited the macOS support and cherry-picked parts from your branch. I credited you in the macOS instructions in the README."
The contributor responded graciously and committed to fixing remaining 1.8" display issues over the weekend. The PR also included a refactored UI layout system with ui_layout.h split for better hardware portability.
The 1.8" Waveshare ESP32-S3 board with SH8601 display driver was being ported, with questions about FT3168 touch controller support. The community discussion focused on whether the existing touch driver could handle the different touch controller or if custom calibration was needed for the smaller screen size.
Clawdmeter is a brilliant intersection of embedded hardware and AI tooling observability. With TechCrunch coverage, active open-source contributions, and a clear expansion roadmap (more boards, more platforms), it's an excellent example of how the AI developer community is building physical feedback tools around LLM usage. If you're a heavy Claude Code user and want a tangible way to track your usage patterns, this is a weekend project worth building.