为什么值得关注

它在原始 Clawdmeter 的基础上增加了仪表盘风格的状态页面（时钟、天气、智能体活动）、通过板载扬声器播放的每日语音问候，以及实时的 Claude Code 用量环，同时保持为业余爱好项目，与 Anthropic 无任何官方关联。

适合谁使用

希望在工作台上实时查看 Claude Code API 用量的重度用户
尝试自制 ESP32-S3 AMOLED 显示屏的硬件爱好者
在 tmux 会话中运行后台 Claude 智能体的 AI 开发者
寻找实用且可定制的环境屏显的桌面爱好者

典型使用场景

无需打开浏览器即可实时监控 Claude Code 会话限制和每周限制
作为带实时伦敦天气和明日预报的桌面时钟使用
通过彩色圆点追踪多个后台 AI 智能体的运行状态与活动
每天两次接收激励性的早晨问候和晚间放松提醒

项目优势

通过 Anthropic API 实现 Claude Code 实时用量集成，显示会话和每周限制
板子与 Python 守护进程（macOS）之间通过 BLE 通信，守护进程可在登录时自动启动
天气地点、智能体圆点和语音消息均可通过配置文件或辅助工具自定义
采用 MIT 开源许可（资产除外），支持多种 Waveshare 开发板

使用前须知

需要特定的 Waveshare ESP32-S3-Touch-AMOLED 硬件以及运行额外功能的 macOS 主机
依赖 macOS 钥匙串中的 Claude Code OAuth 令牌；令牌过期可能导致数据陈旧，需配合 keep-warm 工作区
智能体圆点仅针对特定的 tmux 多智能体配置，其他环境下保持空闲

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

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

Hardware

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

项目描述

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.

clawdmeter-plus