Claude Code Quota ESP32 Display

Vibe Coder, Builder · 2026 · A few hours · 1 person · 1 min read · Updated · github.com

A physical desk display that shows Claude Code quota usage in real time on an ESP32.

Claude CodeCircuitPythonAdafruit ESP32-S3 Reverse TFT

Overview

You wouldn't type /time to check the clock — you'd look at the one on your desk. Same idea, but for Claude Code quota. Half joking.

Problem

No ambient way to track Claude Code quota. Checking /usage requires context-switching and doesn't stick in your head.

Approach

Single-file CircuitPython script — connects to WiFi, polls the Anthropic usage API, renders quota bars on the ST7789 display. Refreshes every 15 minutes.

Constraints

  • Must run standalone on a microcontroller with no desktop dependencies
  • CircuitPython ecosystem — limited libraries and memory
  • OAuth token refresh not available on-device; relies on long-lived access token

Key Decisions

CircuitPython over MicroPython or Arduino

CircuitPython has first-class Adafruit hardware support and a simpler development loop — just copy files to the CIRCUITPY drive.

Alternatives: MicroPythonArduino/C++

Adafruit ESP32-S3 Reverse TFT

Built-in display, WiFi, and USB-C in a compact form factor. No wiring or soldering required.

Alternatives: ESP32 + separate TFT displayRaspberry Pi Zero with e-ink

Result & Impact

Quota is now glanceable — no context-switching needed.

Learnings

  • CircuitPython makes hardware prototyping surprisingly fast — edit, save, run.
  • Sometimes the best solution to a software problem is a physical object on your desk.
All projects