Clawdmeter visualizes Claude Code usage on desktop

๐กEasily monitor your Claude Code usage stats with this new open-source desktop dashboard.
โก 30-Second TL;DR
What Changed
Provides real-time tracking of Claude Code usage
Why It Matters
Helps developers manage their AI usage costs and efficiency by providing immediate visibility into token or request consumption.
What To Do Next
Install Clawdmeter if you are a heavy Claude Code user to better track your usage limits and billing.
Key Points
- โขProvides real-time tracking of Claude Code usage
- โขFeatures a compact, unobtrusive desktop dashboard
- โขOpen-source tool tailored for AI coding power users
๐ง Deep Insight
Web-grounded analysis with 16 cited sources.
๐ Enhanced Key Takeaways
- โขClawdmeter is built on a Waveshare ESP32-S3-Touch-AMOLED-2.16 development board, featuring a 2.16-inch 480x480 AMOLED display and a capacitive touch controller.
- โขThe device communicates with a host daemon over Bluetooth Low Energy (BLE), where the daemon retrieves Claude Code usage data by making minimal API calls to Anthropic's API and parsing response headers like
anthropic-ratelimit-unified-5h-utilization. - โขBeyond visualization, Clawdmeter includes physical buttons that function as a BLE HID keyboard, sending 'Space' for Claude Code's voice mode and 'Shift+Tab' for mode toggling, which can operate system-wide.
- โขThe project incorporates dynamic pixel-art 'Clawd' animations, sourced from the
claudepixlibrary, which become more active as Claude Code utilization increases, offering an intuitive visual cue of consumption levels. - โขClawdmeter's creator, Herman Haraldsson, has noted a licensing 'gray area' due to the project's use of Anthropic's proprietary fonts and copyrighted assets, advising caution for those forking the repository.
๐ Competitor Analysisโธ Show
| Feature / Tool | Clawdmeter (HermannBjorgvin) | Claude Code Usage Monitor (Maciek-roboblog) | AI Meter (sprAI & prAI) | Datadog's AI Agents Console | ccusage (ryoppippi) |
|---|---|---|---|---|---|
| Type | Physical ESP32 desktop dashboard | Terminal-based monitoring tool | macOS menu bar app | Enterprise observability platform | CLI tool for local file analysis |
| Data Source | Anthropic API headers via local daemon | Claude AI token usage (real-time, local) | Claude Code & Codex API limits | Claude Code telemetry (enterprise-level) | Local JSONL files (~/.claude/projects/*.jsonl) |
| Display | 2.16" AMOLED screen, pixel-art animations, usage percentages | Rich terminal UI with color-coded analytics | Menu bar icons, color-coded limits, notifications | Unified dashboard, real-time overview, cost/ROI tabs | Tables for daily, monthly, session reports |
| Key Metrics | Session & weekly utilization, time-to-reset | Token consumption, burn rate, cost analysis, session limits | 5-hour session & 7-day weekly limits, notifications | Total spend, token usage, user activity, error rates, latency, ROI | Token usage, costs, 5-hour blocks, model tracking |
| Additional Features | BLE HID keyboard shortcuts (Space, Shift+Tab) | ML-based predictions, multi-plan support, custom reset times | Multi-provider support (Codex), auto-refresh, launch at login | Performance/reliability trends, Git commits/PRs, model-specific cost | Model breakdown, date filtering, statusline integration |
| Target User | Individual power users of Claude Code | Developers, individual users | Individual developers using AI coding tools | Engineering leaders, organizations | Developers, individual users |
| Pricing | Open-source (hardware cost extra) | Free, open-source | Free, open-source | Subscription-based (Datadog platform) | Free, open-source |
๐ ๏ธ Technical Deep Dive
- Hardware Platform: Built on the Waveshare ESP32-S3-Touch-AMOLED-2.16 development board, which integrates an ESP32-S3R8 SoC.
- Display: Features a 2.16-inch AMOLED screen with a 480x480 resolution (314 PPI) and a CST9220 capacitive touch controller.
- Power Management: Utilizes an AXP2101 PMU for power management and Li-Po battery charging, allowing for untethered operation.
- Connectivity: Communicates with a host computer (Linux, macOS in development) via Bluetooth Low Energy (BLE) using the NimBLE stack.
- Host Daemon: A background daemon running on the host machine reads the user's Claude Code OAuth token from
~/.claude/.credentials.json. - API Interaction: The daemon makes minimal API calls to
api.anthropic.com/v1/messages(e.g., one token of Haiku) to retrieve usage statistics from Anthropic API response headers, specificallyanthropic-ratelimit-unified-5h-utilizationand related fields. - UI Framework: The device's high-resolution user interface is powered by the LVGL graphics library.
- Dynamic Visuals: Pixel-art 'Clawd' animations, sourced from
claudepix.vercel.app, are converted into RGB565 C arrays for the firmware using Node.js tools (scrape_claudepix.js,convert_to_c.js) and react to real-time API utilization rates. - HID Functionality: Physical buttons on the device send standard BLE HID keyboard reports (Space and Shift+Tab) to the paired host, enabling shortcuts for Claude Code's voice mode and mode toggling.
๐ฎ Future ImplicationsAI analysis grounded in cited sources
โณ Timeline
๐ Sources (16)
Factual claims are grounded in the sources below. Forward-looking analysis is AI-generated interpretation.
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
- Google Search Source
Weekly AI Recap
Read this week's curated digest of top AI events โ
๐Related Updates
AI-curated news aggregator. All content rights belong to original publishers.
Original source: TechCrunch AI โ

