Claude Code usage

Clawdmeter Plus

A round AMOLED desk display for your live Claude Code usage, weather, background-agent health, and a daily voice greeting. ESP32-S3 + macOS BLE daemon. Fork of Clawdmeter.

Install

Install
brew install platformio        # provides the `pio` CLI

Found in the project README. Check it for setup steps after installing.

From source
git clone https://github.com/sorryhumans/clawdmeter-plus.git

From the README

Clawdmeter Plus

A tiny round AMOLED desk display that shows your live Claude Code usage, the
time, the London weather, the health of your background agents, and an animated
pixel mascot - and greets you out loud twice a day. It runs on a
Waveshare ESP32-S3-Touch-AMOLED-2.16
and talks to a small macOS daemon over Bluetooth LE.
This is a personal fork/extension of the open-source
Clawdmeter by Hermann Bjorgvin.
It is an independent, unofficial hobby project and is not affiliated with,
endorsed by, or sponsored by Anthropic. See Credits & License.
The finished build on my desk. The crisp screenshots further down are captured
straight off the panel's framebuffer.

What it shows

The display has two pages. Press the middle PWR button to flip between them.

1. Usage screen (the core)

Your live Claude Code limits, straight from the Anthropic usage API:

- Session limit (the rolling 5-hour window) and weekly limit, as rings/bars
- Current burn rate, so you can see how fast you're spending
- An animated Clawd pixel mascot
- Optional clock in place of the "Usage" title

2. Status screen (this fork's additions)

A bento-style dashboard:

- Clock (12h/24h)
- London weather - current temperature + a condition icon (open-meteo, no API key)
- Tomorrow - tomorrow's forecast high + icon
- Agent dots - five health dots for background Claude agents running in a local
  tmux session, each with an identity icon. Whichever agent is *actively working*
  gets a pulsing orange highlight behind its cell.
- The animated mascot, on this page too

The agent-dots panel is tailored to a specific multi-agent setup (it looks for
named tmux windows). If you don't run agents that way the dots simply stay
idle - everything else works unchanged. See Customizing.

Controls

Hardware

Other boards in the…
Read the full README on GitHub

Details

Language
C
Last updated
15 July 2026
Topics
amoledarduinobluetooth-leclaude-codedesk-accessoryesp32esp32-s3lvglplatformiowaveshare

FAQ

What is Clawdmeter Plus?

A round AMOLED desk display for your live Claude Code usage, weather, background-agent health, and a daily voice greeting. ESP32-S3 + macOS BLE daemon. Fork of Clawdmeter. It is a usage for Claude Code, from sorryhumans/clawdmeter-plus on GitHub.

How do I install Clawdmeter Plus?

Run brew install platformio # provides the `pio` CLI, then follow the setup in the README.

Is Clawdmeter Plus popular?

sorryhumans/clawdmeter-plus has 94 GitHub stars and 7 forks. It was last updated on 15 July 2026.

More usage & cost trackers

Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.