HermannBjorgvin/Clawdmeter

ESP32 desk dashboard that shows Claude Code usage

它解决了什么问题

Clawdmeter 是一款物理桌面仪表盘,用于监控 Claude Code 的使用情况和速率限制。它提供了会话和每周使用率的实时可视化指示,减少了在软件内手动查看使用统计数据的需求。

工作原理

  • 数据获取:一个后台守护进程 (Python) 在主机 (macOS, Linux 或 Windows) 上运行,读取用户的 Claude OAuth token,并轮询 Anthropic API 以获取使用情况标头。
  • 通信:守护进程通过低功耗蓝牙 (BLE) 将使用数据推送到基于 ESP32 的设备。
  • 显示:固件 (C++/LVGL) 解析 JSON 有效负载,并在 AMOLED 屏幕上更新使用百分比和重置计时器。
  • 视觉效果:该设备具有吉祥物“Clawd”的像素艺术动画,这些动画会根据使用率而变化。
  • 控制:该设备充当 BLE HID 键盘,允许用户直接向主机发送快捷键 (Space 用于语音模式,Shift+Tab 用于模式切换)。

适用人群

希望为 AI 使用限制配备专用硬件监控器以及物理快捷键控制器的 Claude Code 开发者和高级用户。

亮点

  • 多平台支持:提供 macOS, Linux 和 Windows 的专用安装程序。
  • 硬件灵活性:开箱即用,支持多种 Waveshare ESP32-S3/C6 AMOLED 开发板。
  • 交互式动画:基于使用率的动画和注意力提醒,在 Claude Code 等待输入时通知用户。
  • HID 集成:用于一键通话和模式切换的物理按钮。
  • 可定制:包含用于 UI 迭代的桌面模拟器,以及将资源转换为 C 数组的工具。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目