HermannBjorgvin/Clawdmeter

ESP32 desk dashboard that shows Claude Code usage

解決する課題

Clawdmeterは、Claude Codeの使用状況とレート制限を監視するための物理的なデスクダッシュボードです。セッションおよび週間の利用状況をリアルタイムで視覚的に表示し、ソフトウェア内で手動で使用統計を確認する手間を省きます。

仕組み

  • データ取得: ホストマシン(macOS、Linux、Windows)上でバックグラウンドデーモン(Python)が実行され、ユーザーのClaude OAuthトークンを読み取り、Anthropic APIをポーリングして使用状況ヘッダーを取得します。
  • 通信: デーモンは、Bluetooth Low Energy (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配列に変換するためのツールが含まれています。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト