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
Background and context from public sources — not the original article. 16 sources cited.
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
- Clawdmeter (HermannBjorgvin)
- Physical ESP32 desktop dashboard
- Claude Code Usage Monitor (Maciek-roboblog)
- Terminal-based monitoring tool
- AI Meter (sprAI & prAI)
- macOS menu bar app
- Datadog's AI Agents Console
- Enterprise observability platform
- ccusage (ryoppippi)
- CLI tool for local file analysis
- Clawdmeter (HermannBjorgvin)
- Anthropic API headers via local daemon
- Claude Code Usage Monitor (Maciek-roboblog)
- Claude AI token usage (real-time, local)
- AI Meter (sprAI & prAI)
- Claude Code & Codex API limits
- Datadog's AI Agents Console
- Claude Code telemetry (enterprise-level)
- ccusage (ryoppippi)
- Local JSONL files (
~/.claude/projects/*.jsonl)
- Clawdmeter (HermannBjorgvin)
- 2.16" AMOLED screen, pixel-art animations, usage percentages
- Claude Code Usage Monitor (Maciek-roboblog)
- Rich terminal UI with color-coded analytics
- AI Meter (sprAI & prAI)
- Menu bar icons, color-coded limits, notifications
- Datadog's AI Agents Console
- Unified dashboard, real-time overview, cost/ROI tabs
- ccusage (ryoppippi)
- Tables for daily, monthly, session reports
- Clawdmeter (HermannBjorgvin)
- Session & weekly utilization, time-to-reset
- Claude Code Usage Monitor (Maciek-roboblog)
- Token consumption, burn rate, cost analysis, session limits
- AI Meter (sprAI & prAI)
- 5-hour session & 7-day weekly limits, notifications
- Datadog's AI Agents Console
- Total spend, token usage, user activity, error rates, latency, ROI
- ccusage (ryoppippi)
- Token usage, costs, 5-hour blocks, model tracking
- Clawdmeter (HermannBjorgvin)
- BLE HID keyboard shortcuts (Space, Shift+Tab)
- Claude Code Usage Monitor (Maciek-roboblog)
- ML-based predictions, multi-plan support, custom reset times
- AI Meter (sprAI & prAI)
- Multi-provider support (Codex), auto-refresh, launch at login
- Datadog's AI Agents Console
- Performance/reliability trends, Git commits/PRs, model-specific cost
- ccusage (ryoppippi)
- Model breakdown, date filtering, statusline integration
- Clawdmeter (HermannBjorgvin)
- Individual power users of Claude Code
- Claude Code Usage Monitor (Maciek-roboblog)
- Developers, individual users
- AI Meter (sprAI & prAI)
- Individual developers using AI coding tools
- Datadog's AI Agents Console
- Engineering leaders, organizations
- ccusage (ryoppippi)
- Developers, individual users
- Clawdmeter (HermannBjorgvin)
- Open-source (hardware cost extra)
- Claude Code Usage Monitor (Maciek-roboblog)
- Free, open-source
- AI Meter (sprAI & prAI)
- Free, open-source
- Datadog's AI Agents Console
- Subscription-based (Datadog platform)
- ccusage (ryoppippi)
- Free, open-source
| 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
- 2023-03Anthropic releases Claude AI chatbot.
- 2025-05Anthropic releases Claude Sonnet 4 and Claude Opus 4, introducing API features including a code execution tool.
- 2025-08Anthropic releases Claude for Chrome, allowing Claude Code to control the browser.
- 2025-10Anthropic releases web version and iOS app for Claude; Claude Haiku 4.5 is released.
- 2026-02Anthropic introduces Claude Code Security for codebase vulnerability review.
- 2026-05HermannBjorgvin's Clawdmeter project, an ESP32 desk dashboard for Claude Code usage, becomes publicly active on GitHub and is featured in tech news.
Sources (16)
Factual claims are grounded in the sources below. Forward-looking analysis is AI-generated interpretation.
Weekly AI Recap
Read this week's curated digest of top AI events →
AI-curated news aggregator. All content rights belong to original publishers.
Original source: TechCrunch AI ↗
This is a summary, not the original. Read the source, or get the weekly briefing.
The weekly digest
One email a week. Unsubscribe anytime.
