Clawdmeter turns your Claude Code usage stats into a tiny desktop dashboard

A new open-source hardware project called Clawdmeter brings Claude Code token usage data to a dedicated desktop display, giving AI power users a physical window into their consumption habits. The device, built by Reykjavik-based software developer Hermann Haraldsson, combines pixel-art animations with real-time utilization charts, turning a terminal command into a tangible, nostalgic experience.

From terminal to tangible

Haraldsson, who describes himself as not an embedded developer, told Bitcoin World that Claude Code itself helped him build the project in just a few days. “It’s really democratized access to programming, so that anyone can now do what developers used to do,” he said. The bulk of his time went into design—getting the font, colors, and animations just right.

The device uses a small lithium-ion battery-powered display like the Waveshare ESP32-S3-Touch-AMOLED-2.16, which pairs with a laptop over Bluetooth. When powered on, the splash screen plays pixel-art Clawd animations that become more energetic as token usage increases. A middle button cycles through different animation styles, and pressing it again reveals session and weekly utilization data in simple charts. Two additional side buttons send keyboard shortcuts for Claude Code’s voice mode and mode-toggle features.

How it works

The Clawdmeter reads the user’s Claude Code OAuth token to make an API call, pulling usage numbers directly from response headers. Because the project is open source, anyone can fork it to add custom features, animations, or screens. Since its launch on May 10, over 800 people have starred it on GitHub, and 50 have already forked the repository.

Haraldsson believes the device’s appeal lies partly in nostalgia. “There’s a kind of nostalgia for when you used to have a hardware device for everything—like a Walkman to play music, or an iPod,” he said. One Reddit user called it a “hardware Tamagotchi for my context window.”

Tokenmaxxing and the cultural shift

The project arrives amid a growing trend among software engineers called “tokenmaxxing,” where developers maximize the number of AI tokens consumed at work as a measure of AI adoption. While the Clawdmeter is primarily a fun side project, it also reflects how deeply tools like Claude Code have embedded themselves into developer workflows. As one Reddit user joked: “At this point, Anthropic should just mail these to us for free.”

Conclusion

The Clawdmeter is a lighthearted but technically interesting example of how AI usage is moving beyond the terminal and into physical space. For developers who want a real-time, visual reminder of their token consumption—or just a bit of pixel-art dopamine during a coding session—it offers a customizable, open-source solution.

FAQs

Q1: What hardware do I need to build a Clawdmeter?
A: The project uses a Waveshare ESP32-S3-Touch-AMOLED-2.16 display or similar small lithium-ion battery-powered screen that pairs with a laptop over Bluetooth.

Q2: Is the Clawdmeter project free and open source?
A: Yes. The code is available on GitHub under an open-source license, and anyone can fork it to add custom features, animations, or screens.

Q3: Does the device require any special software to track Claude Code usage?
A: It reads your Claude Code OAuth token to make an API call, pulling usage numbers directly from the response headers. No additional software is needed beyond the open-source firmware.