This is a small always-on desk widget built around the LILYGO TTGO T-Display (ESP32 + 1.14" IPS LCD). It shows your Claude.ai usage limits at a glance, color coded green/yellow/red, so you always know how much of your session budget you've spent.
Key feature of this device: No API usage, No claude usage, completly free!
Page 1 — Session view:
- Current 5-hour session usage (big percentage, color-coded)
- Live countdown till reset (ticks every second), when limit is reached
- Weekly usage in the subtitle
Page 2 — Overview dashboard:
- Session, Weekly, Claude Design, and Credits usage, all in one view
- Press the physical button to switch between pages.
The ESP32 can't talk to Claude's API directly (no HTTPS to internal endpoints, and Cloudflare bot protection). Instead, a small Python server runs on your PC:
- The server calls
claude.ai/api/organizations/{org_id}/usageusing your browser session cookie, with Chrome TLS impersonation viacurl_cffito bypass Cloudflare - The ESP32 polls the local server over HTTP every 10 seconds
- The server caches responses for 15 seconds, no unnecessary requests
- NO API credit usage!
Your session cookie never leaves your local network. Usually the cookie stays active for weeks or even months, unless you logout of your claude account. if that happens a notification on the device will appear and you will need to update the cookie, that's all. No API usage, No claude usage, completly free and can update as much as you want!
The problem with the limit avalible in the command line or the response header, is that it's not accurate. That info will only cover the current session usage, not the account usage. Since the account usage is not standard publicly avalible. That is the reson I choose to do it this way with the seccionkey cookie. Ofcourse the downside is that you need to extract the cookie from the web interface.
You are also able to add a small battery on the back of the board, this way it can run completly stand-alone.
EnclosureThe enclosure is not perfect, but it works (i did shave a slice off of the reset button to prefent it from triggering accidentaly).
it can be easily 3d printed, a desk stand is also avalible.
Comments