explaingit

sorryhumans/clawdmeter-plus

Analysis updated 2026-05-18

★ 86CAudience · developerComplexity · 4/5Setup · hard

TLDR

A round AMOLED desk display, paired with a Mac daemon over Bluetooth, that shows live Claude Code usage, weather, and background agent health.

Mindmap

mindmap
  root((repo))
    What it does
      Shows live Claude Code usage
      Shows weather and clock
      Tracks background agent health
    Tech stack
      C++ firmware
      PlatformIO and LVGL
      Python macOS daemon
    Use cases
      Monitor Claude usage limits
      Watch background agents
      Desk accessory display
    Audience
      Claude Code power users
      Hardware hobbyists
    Hardware
      Waveshare ESP32-S3 AMOLED
      Optional LiPo battery
      Bluetooth LE
    Setup
      Flash firmware
      Run Mac daemon
      Pair over Bluetooth

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Keep an always visible desk display of your rolling five hour and weekly Claude Code usage limits.

USE CASE 2

See at a glance which background Claude agents are currently active in your tmux session.

USE CASE 3

Get a quick local weather check without opening a phone or browser.

USE CASE 4

Build a personal customized hardware fork of an existing open source desk gadget.

What is it built with?

C++PlatformIOPythonBluetooth LE

How does it compare?

sorryhumans/clawdmeter-plusuiseries/ai-robotlinuxoid-cn/cve-2026-43499-poc-analysis
Stars868483
LanguageCCC
Setup difficultyhardhardhard
Complexity4/55/54/5
Audiencedeveloperdeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires specific ESP32-S3 AMOLED hardware, firmware flashing, and a paired macOS Bluetooth daemon.

The README does not show the license terms directly, it points to a separate credits and license section.

In plain English

Clawdmeter Plus is a small round screen you keep on your desk that shows your live Claude Code usage in real time, along with the current time, London weather, the health of any background AI agents you have running, and an animated pixel mascot. Twice a day it also greets you out loud. It runs on a specific piece of hardware, the Waveshare ESP32-S3-Touch-AMOLED-2.16, and talks to a small companion program running on a Mac over Bluetooth Low Energy. It is a personal fork of an existing open source project called Clawdmeter, built as an independent hobby project with no official connection to Anthropic. The display has two pages you flip between with the middle power button. The first is the usage screen, which pulls your live Claude Code limits straight from the Anthropic usage API and shows your rolling five hour session limit and weekly limit as rings or bars, along with your current burn rate. The second page, added in this fork, is a status dashboard showing a clock, current and next day weather for London pulled from a free weather service with no API key needed, and a row of health dots representing background Claude agents running in a local tmux session, with the currently active agent highlighted by a pulsing glow. The hardware itself is a 480 by 480 round touchscreen board with a built in speaker and USB-C port, optionally paired with a small rechargeable battery for cordless use. Setting it up involves flashing custom firmware written in C++ using the PlatformIO toolchain, then installing and running a small Python daemon on your Mac that reads your Claude Code login credentials directly from the macOS Keychain, the same ones Claude Code itself already uses, so no token needs to be stored in the project. Once paired over Bluetooth, the daemon sends an update to the device roughly every 60 seconds. Configuration is handled through a plain text file that can be edited without restarting anything, controlling things like the clock format and whether a chime plays when your session limit resets.

Copy-paste prompts

Prompt 1
Walk me through flashing this firmware onto a Waveshare ESP32-S3-Touch-AMOLED-2.16 board.
Prompt 2
Help me install and run the macOS daemon that connects this display to my Claude Code usage.
Prompt 3
Explain how this project reads my Claude Code credentials from the macOS Keychain safely.
Prompt 4
Show me how to configure the clock format and chime settings in the daemon config file.
Prompt 5
Explain how the background agent health dots work and what tmux setup they expect.

Frequently asked questions

What is clawdmeter-plus?

A round AMOLED desk display, paired with a Mac daemon over Bluetooth, that shows live Claude Code usage, weather, and background agent health.

What language is clawdmeter-plus written in?

Mainly C. The stack also includes C++, PlatformIO, Python.

What license does clawdmeter-plus use?

The README does not show the license terms directly, it points to a separate credits and license section.

How hard is clawdmeter-plus to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is clawdmeter-plus for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos