Clawdmeter Plus is a fork of the open-source Clawdmeter that turns a Waveshare ESP32-S3 AMOLED display into a live Claude Code usage monitor with weather, agent health dots, and daily voice greetings, all driven by a macOS Bluetooth LE daemon.

Stars

86

7-day growth

No data

Forks

6

Open issues

0

License

NOASSERTION

Last updated

2026-07-15

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It extends the original Clawdmeter with a bento-style status dashboard (clock, weather, agent activity), daily voice greetings through the onboard speaker, and a live Claude Code usage ring, all while remaining a hobby project with no official Anthropic affiliation.

Who it is for

  • Claude Code power users who want real-time API usage visibility on their desk
  • Hardware tinkerers interested in building custom ESP32-S3 AMOLED displays
  • AI agent developers running background Claude agents in tmux sessions
  • Desk enthusiasts looking for a practical, customizable ambient display

Use cases

  • Monitoring your Claude Code session and weekly limits without opening a browser
  • Using as a desk clock with live London weather and tomorrow's forecast
  • Tracking health and activity of multiple background AI agents via colored dots
  • Receiving a motivational morning greeting and evening wind-down message twice a day

Strengths

  • Live Claude Code usage integration via Anthropic API with session and weekly limits
  • BLE-based communication between the board and a Python daemon (macOS) that runs at login
  • Fully customizable weather location, agent dots, and voice messages via config file or helper tools
  • Open-source MIT license (with asset restrictions) and support for multiple Waveshare boards

Considerations

  • Requires specific Waveshare ESP32-S3-Touch-AMOLED hardware and a macOS host for the daemon's extra features
  • Depends on Claude Code OAuth token from macOS Keychain; token expiry may lead to stale data without a keep-warm workaround
  • Agent dots are hardcoded to a particular tmux multi-agent setup; unused otherwise

README quick start

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

ActionWhat it does
Tap PWR (middle button)Cycle pages: Usage ⟷ Status
Hold PWR ~3 sPairing mode (clears the Bluetooth bond)
Side buttonsBLE HID keys you can use inside Claude Code (e.g. push-to-talk)

Hardware

PartNotes
**[Waveshare ESP32-S3-Touch-AMOLED-2.16](https://www.

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.

Related repositories

Similar projects matched by category, topics, and programming language.

makecindy
Featured
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI & Machine LearningLarge Language Models
958
0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

openclaude-improved

OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.

AI & Machine LearningLarge Language Models
577
0xwilliamortiz
Featured
0xwilliamortiz GitHub avatar

ponytail-improved

Ponytail is a plugin for AI coding agents that enforces a disciplined ladder of reuse before writing code, reducing code volume by roughly 54% while preserving safety.

AI & Machine LearningAI Agents
545