Clawdmeter Plus banner
sorryhumans sorryhumans

Clawdmeter Plus

Development community

Description

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.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

clawdmeter plus

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](https://www.waveshare.com/esp32-s3-touch-amoled-2.16.htm?&aff_id=149786) and talks to a small macOS daemon over Bluetooth LE.

This is a personal fork/extension of the open-source [**Clawdmeter** by Hermann Bjorgvin](https://github.com/HermannBjorgvin/Clawdmeter). It is an independent, **unofficial** hobby project and is not affiliated with, endorsed by, or sponsored by Anthropic. See [Credits & License](#credits--license).

Clawdmeter on a desk showing the usage screen Clawdmeter on a desk showing the status screen

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

Usage screen showing session and weekly Claude Code limits Animated Clawd mascot splash

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)
  • **Tomor