SixSigmaEngineer/

Claude-Status-Bar-Lilygo

GitHub

Claude Status Bar for LilyGo displays streams live Claude status (model, tool, tokens, context, rate limits) from desktop apps to a hardware display via a bridge and firmware. It supports Windows desktop app and ESP32-S3 firmware, with per-session state and real usage from Anthropic when available.

11stars

2forks

0issues

MITlicense

2026since

Star historydaily snapshots by VibeCrowd

Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).

Reviewgenerated from repository data · Jul 18, 2026

What it is

A project that provides a live hardware status display for Claude on a LilyGo T-Display S3 Long. It shows current model, the tool it's running, elapsed time, tokens in/out, context usage, and rate-limit bars. It integrates with Claude Desktop (Cowork) and Claude Code and supports up to 4 sessions.

How it works

The workflow is:

Claude Desktop / Claude Code writes JSONL transcripts on disk.
bridge/claude_bar_bridge.py tails transcripts, derives per-session state, and polls Anthropic usage API (real limits) or estimates locally.
JSON lines are sent over USB serial at 115200 to firmware/claude_statusbar.ino on the ESP32-S3.
The firmware renders a 640×180 UI and handles touch input.

Per-session state machine progresses through run → tool → wait → done/idle, with auto-follow of the most recently active session or attention to waiting sessions.

Getting started

Prerequisites: Python 3.10+. Steps:

Flash the firmware:
```
powershell -ExecutionPolicy Bypass -File .\build_and_flash.ps1
```
This downloads arduino-cli, ESP32 toolchain, LilyGo drivers, and libraries into C:\ClaudeBarBuild and flashes the device. If the wrong COM port, add -Port COM5.
Test with fake data:
```
bridge\run_bridge.bat --demo
```
Run the app:
```
bridge\run_app.bat
```
The desktop app provides a live preview, logo uploader, tray behavior, and autostart options.

Recent releases

Latest release: v1.0.0 Claude Status Bar v1.0.0 (2026-07-12). Desktop companion app for the Claude Status Bar hardware display (LilyGo T-Display S3 Long) with firmware flashing notes.

Traction

Stars: 11 Forks: 2 Open issues: 0

Caveats

License: MIT Platform: Windows (Python 3.10–3.13) with ESP32-S3 firmware Created: 2026-07-11 Last push: 2026-07-12 Configuration hints: tune est_cap_5h_tokens / est_cap_7d_tokens in bridge\config.json; copy from config.example.json

SharePost on X LinkedIn