archeious/claude-gauge
1
0
Fork 0
Code Issues 1 Pull requests 1 Projects Releases Packages Wiki Activity Actions
Page: Ecosystem
Pages
Architecture DataSources Ecosystem Hardware Home Ideas Roadmap Session1 SessionRetrospectives
1 Ecosystem
archeious edited this page 2026-04-17 19:44:01 -06:00
Table of Contents

Ecosystem

Survey of prior art relevant to claude-gauge, captured during initial research in April 2026. Establishes what exists, what to borrow, and where claude-gauge can uniquely contribute.

Direct cousins

Projects that do essentially the same thing claude-gauge does: a software metric driving a physical analog needle cluster.

Liam Jackson — CI Test Tachometer Dashboard

The closest cousin. Three universal motorcycle tachometers wired to an Arduino, displaying continuous-integration test failure counts in real time. OLED in the center for context numbers.

  • Hardware: sub-$10 motorcycle tachs, Arduino, 3D-printed housing
  • Signal: frequency-based PWM (1000 RPM = 16.66 Hz), "Slow PWM" library
  • Power: several hundred mA at high deflection
  • Source: Printables STL for the housing, code inline in the Hackaday writeup
  • Reference: Putting Cheap Motorcycle Tachometers To Work

John McLear — AstraDash (Astra GTE -> Home Assistant)

Repurposed Astra GTE car dashboard driven by ESP32 showing Home Assistant sensor data. Every 5 s, MQTT pushes a JSON payload ({oilTemp, battery, coolantTemp, fuelLevel, rpm, speedo}) that gets mapped arbitrarily to home metrics. EV charge becomes fuel level, task count becomes speedometer, solar output becomes RPM.

Lesson: the /usage JSON shape we designed for the firmware is the same abstraction McLear uses. Validates the architecture.

Evan — Kegerator Gauge Cluster

Salvaged Chevy cluster driving analog meters that show beer temp and "fuel" (keg volume). Pressure sensors on a scale beneath the keg, plus a flow sensor on the tap line. LEDs for drama during pour events.

  • Pattern: automotive cluster as purpose-built hobby display
  • Reference: listed on Hackaday under the gauge-cluster tag

Steampunk voltmeter projects

Widespread Home Assistant community pattern: repurpose vintage voltmeters as ambient displays via ESPHome. PWM driven through an RC low-pass filter to smooth the needle. Used for tank levels, battery state, network load, etc.

  • Pattern: ESPHome + vintage meter body = instant Home Assistant integration
  • Reference: Home Assistant community threads on MQTT DC voltmeters, analog gauge dashboards

Adjacent projects

Same hardware pattern (ESP32 + display + metric), different data or display choice.

Ecasti — PrometheusClient

Probably the most interesting adjacency. ESP32 pulls from Prometheus via HTTP and renders time-series graphs, gauge displays, and stat panels on integrated LCDs (M5Stack Tab5 / AtomS3 / CoreS3). Supports HTTPS and Grafana Cloud. Apache-2.0.

Studying the HTTP query loop and caching patterns saves real daemon-design time. The digital cousin of claude-gauge; swap the displays for steppers and you're at claude-gauge.

Source: ecasti-gmail-com/PrometheusClient Article: Prometheus Dashboards on ESP32

r00li — CarCluster

Drives real automotive instrument clusters from a PC via ESP32. Primary use case: driving simulators (Assetto, Forza). Bit-bangs SPI to the target cluster.

Source: r00li/CarCluster

YouTube / Twitch subscriber counters

Pattern well-represented but exclusively digital: MAX7219 matrices, OLEDs, 7-segment. No physical-needle variants found. Example: joeybab3/Live-Subscriber-Counter.

Bitcoin / crypto tickers

Similarly digital-only. OLED + API fetch every N seconds. A GitHub project sandman72/ESP32_BitcoinMeter hints at a meter variant but isn't widely built.

Classic-car instrument restorations (Triumph GT6, Alfa Giuletta)

Replace mechanical gauges with LCD. Different problem shape; not applicable.

Hardware building blocks

SwitecX25 driver library

The canonical Arduino library for X25, X27.168, VID28, VID29, BKA30D-R5 steppers. Direct GPIO, no external driver IC strictly required (though ULN2003A recommended for cleaner current).

Source: clearwater/SwitecX25

Reference Arduino X27 build

Full working Arduino code and wiring for X27 stepper + OLED overlay.

Source: nsocwx/Digital-Speedometer

TheRengineer Analog Gauge Stepper Motor PCB

Pre-made driver board for X27.168 / VID28 with JST connectors. Skips the breadboard stage.

Source: Tindie listing

Universal motorcycle tachometers

$5-10 on overseas retailers. 12 V nominal but respond to 5 V logic. Frequency-driven (1000 RPM = 16.66 Hz). Larger and more visually readable at desk distance than X27.168. Good V1 prototype path.

Vintage analog voltmeters

Etsy listings for Bakelite-body industrial voltmeters, steampunk aesthetic ready. Typical $10-30. Drill for wiring, repurpose the movement, done.

Middleware and framework options

ESPHome

Home-Assistant-native framework for driving PWM-controlled analog meters. If the claude-gauge daemon exposes a Home Assistant sensor, ESPHome handles the firmware layer automatically.

Trade-off: less firmware control, faster path to a moving needle. Worth prototyping on.

Grafana Labs dashboard 25052

Pre-built Claude Code metrics dashboard. Free deep-stats surface for architecture A. Import against Prometheus; done.

Anthropic claude-code-monitoring-guide

Official reference Docker Compose stack: OTEL collector + Prometheus

  • Grafana. Borrow wholesale for architecture A.

Source: anthropics/claude-code-monitoring-guide

Aesthetic references

  • Retro-futuristic automobile control panel (Hackaday.io project 10579): 1960s dashboard with modern guts.
  • Daniel Lazo's Retro Digital Dashboards (Behance): art direction for cluster visuals.
  • Dieselpunk cellphone (Make Magazine): aesthetic coherence lesson.
  • Bakelite industrial voltmeters (Etsy): housing reuse options.

Curated lists checked

Physical-gauge variants are under-represented in curated lists, which itself is a signal.

Where claude-gauge uniquely contributes

Axis State of the world claude-gauge angle
Data source HA, CI, kegerator, car sim, crypto LLM telemetry (first)
Gauge metric RPM, temp, fuel, voltage, follower count Thinking-to-output ratio (novel)
Cluster semantics Repurposed car cluster w/ mental legend Purpose-built for token flow (new)
Model indicator n/a Discrete annunciator for active model (new)
Data path portability Locked to one source Dual-architecture (OTEL or ccusage)
Enclosure One-off bespoke Open, printable, replicable
Character metrics n/a Em-dash violator counter, phrase extractor
Physical observability framing Implicit Explicit "make AI work tangible"

What to borrow

  1. Motorcycle tachometers as the V1 prototype hardware. Ship a working needle in a weekend before committing to X27.168.
  2. McLear's JSON-over-MQTT payload abstraction. Confirms the firmware contract is right.
  3. Ecasti's PrometheusClient HTTP query loop and caching patterns. Lift directly for the daemon.
  4. TheRengineer's driver PCB to skip X27.168 breadboarding.
  5. ESPHome firmware as a shortcut path; fall back to hand-rolled Arduino only if needed.
  6. Vintage Bakelite voltmeter case from Etsy: one industrial box housing all four needles, drilled ports. Instant aesthetic win.
  7. Grafana dashboard 25052 verbatim for architecture A's deep stats.