Tổng quan
Clawdmeter là dự án phần cứng mã nguồn mở cho phép bạn tự build một chiếc dashboard vật lý nhỏ gọn để theo dõi mức sử dụng Claude Code API theo thời gian thực. Thiết bị chạy trên ESP32-S3 với màn hình AMOLED 2.16 inch, kết nối không dây với máy tính qua Bluetooth để nhận dữ liệu usage từ một daemon chạy nền.
Điểm thú vị nhất: mascot Clawd pixel-art sẽ hoạt hình sinh động hơn khi usage tăng cao - vừa hữu ích vừa đáng yêu cho góc làm việc của dev.
Các tính năng chính
- 3 màn hình - Splash animation, usage metrics (session + weekly %), trạng thái Bluetooth
- Bluetooth HID - Nút vật lý gửi phím Space (voice mode) và Shift+Tab (mode toggle) thẳng vào Claude Code
- Cross-platform daemon - Hỗ trợ Linux và macOS, tự động poll API usage rồi đẩy lên thiết bị qua BLE
- Pixel-art Clawd - Nhân vật hoạt hình thay đổi animation theo mức usage, phong cách retro game
Phần cứng cần có
- Waveshare ESP32-S3-Touch-AMOLED-2.16 - màn hình AMOLED 480x480, cảm ứng điện dung, có PMU tích hợp
Cài đặt nhanh (macOS)
# Flash firmware lên thiết bị
./flash-mac.sh
# Ghép đôi Bluetooth: System Settings -> Bluetooth -> chọn Clawdmeter
# Cài daemon (LaunchAgent tự chạy mỗi khi login)
./install-mac.shTrên Linux, dùng PlatformIO để flash firmware và systemctl --user start claude-usage-daemon để chạy daemon.
Lưu ý
- Cần có Anthropic API key có quyền đọc usage data
- Clawd mascot sử dụng artwork proprietary của Anthropic - chỉ dùng cho mục đích cá nhân
- Firmware build bằng PlatformIO (C/C++), daemon viết bằng Python
Click button bên trên để xem hướng dẫn đầy đủ tại repo gốc.