claude-gauge

archeious/claude-gauge

Fork 0

Author	SHA1	Message	Date
archeious	958dfd0562	Add Ecosystem survey; expand Ideas with unique-angle shortlist Ecosystem.md synthesises ~2 hours of prior-art research across Hackaday, GitHub, Hackster, Tindie, Etsy, and Home Assistant community. Covers: - Direct cousins: Liam Jackson's CI tachometer dashboard, McLear's AstraDash (Astra GTE -> Home Assistant), Evan's kegerator, the wider steampunk-voltmeter + ESPHome pattern. - Adjacent projects: Ecasti's PrometheusClient on ESP32 (the digital cousin), r00li/CarCluster, the YouTube/Twitch counter and crypto ticker patterns (all digital, no needle variants). - Hardware building blocks: SwitecX25 library, nsocwx reference build, TheRengineer driver PCB, motorcycle tachometers as a V1 shortcut, vintage voltmeter cases from Etsy. - Middleware options: ESPHome for a fast firmware path, Grafana dashboard 25052, claude-code-monitoring-guide. - Uniqueness matrix showing where claude-gauge genuinely contributes (LLM telemetry first, thinking-ratio gauge, model-indicator annunciator, dual-architecture portability, replicable enclosure, character metrics, physical-observability framing). - Concrete "what to borrow" shortlist. Ideas.md rewrites the hardware-wild-ideas section into a unique-angle shortlist with fuller treatments for each: physical model-selector knob, swappable faces per mode, daily reset chime, tactile feedback, per-project LED strip, cluster-to-cluster sync, physical commit button, audio feedback (toggle), second cluster as historical companion. Home.md page index updated to link Ecosystem.	2026-04-17 19:44:01 -06:00
archeious	461679dd64	Initial wiki: six-page documentation set Pages: - Home: overview, cluster-at-a-glance table, page index, with Monitor Dash render embedded. - Architecture: two-architecture tradeoff (A: OTEL-native, B: ccusage-sourced), shared daemon contract (/usage JSON shape), calibration env vars. - DataSources: architecture A implementation (docker-compose, otel-collector-config, prometheus.yml, Claude Code env, claude_code_* metric schema, PromQL per gauge, daemon sketch); architecture B implementation (ccusage CLI vs MCP server, watchdog JSONL tail, daemon sketch); recommendation. - Hardware: four-gauge layout (5h fuel, tach, thinking ratio, cache hit), X27.168 steppers with SwitecX25 library, ESP32 DevKit wiring with concrete GPIO assignments, firmware structure, enclosure V1 notes, BOM (~$80-90). - Roadmap: eight phases (A daemon stdout through H character metrics), deferred list, out-of-scope list. - Ideas: four exotic enclosure variants with render (steampunk chronometer, retro VFD array, minimalist birch e-ink, bio-digital cybernetic cluster), metrics brainstorm organised in seven categories, hardware / software wild ideas, unlikely-but-noted. Images committed: monitor-dash.png referenced from Home and Hardware; exotic-dashes.png referenced from Ideas.	2026-04-17 19:30:38 -06:00

Author

SHA1

Message

Date

archeious

958dfd0562

Add Ecosystem survey; expand Ideas with unique-angle shortlist

Ecosystem.md synthesises ~2 hours of prior-art research across
Hackaday, GitHub, Hackster, Tindie, Etsy, and Home Assistant
community. Covers:

- Direct cousins: Liam Jackson's CI tachometer dashboard, McLear's
  AstraDash (Astra GTE -> Home Assistant), Evan's kegerator, the
  wider steampunk-voltmeter + ESPHome pattern.
- Adjacent projects: Ecasti's PrometheusClient on ESP32 (the
  digital cousin), r00li/CarCluster, the YouTube/Twitch counter
  and crypto ticker patterns (all digital, no needle variants).
- Hardware building blocks: SwitecX25 library, nsocwx reference
  build, TheRengineer driver PCB, motorcycle tachometers as a V1
  shortcut, vintage voltmeter cases from Etsy.
- Middleware options: ESPHome for a fast firmware path, Grafana
  dashboard 25052, claude-code-monitoring-guide.
- Uniqueness matrix showing where claude-gauge genuinely contributes
  (LLM telemetry first, thinking-ratio gauge, model-indicator
  annunciator, dual-architecture portability, replicable enclosure,
  character metrics, physical-observability framing).
- Concrete "what to borrow" shortlist.

Ideas.md rewrites the hardware-wild-ideas section into a
unique-angle shortlist with fuller treatments for each: physical
model-selector knob, swappable faces per mode, daily reset chime,
tactile feedback, per-project LED strip, cluster-to-cluster sync,
physical commit button, audio feedback (toggle), second cluster
as historical companion.

Home.md page index updated to link Ecosystem.

2026-04-17 19:44:01 -06:00

archeious

461679dd64

Initial wiki: six-page documentation set

Pages:
- Home: overview, cluster-at-a-glance table, page index, with
  Monitor Dash render embedded.
- Architecture: two-architecture tradeoff (A: OTEL-native, B:
  ccusage-sourced), shared daemon contract (/usage JSON shape),
  calibration env vars.
- DataSources: architecture A implementation (docker-compose,
  otel-collector-config, prometheus.yml, Claude Code env,
  claude_code_* metric schema, PromQL per gauge, daemon sketch);
  architecture B implementation (ccusage CLI vs MCP server,
  watchdog JSONL tail, daemon sketch); recommendation.
- Hardware: four-gauge layout (5h fuel, tach, thinking ratio,
  cache hit), X27.168 steppers with SwitecX25 library, ESP32
  DevKit wiring with concrete GPIO assignments, firmware
  structure, enclosure V1 notes, BOM (~$80-90).
- Roadmap: eight phases (A daemon stdout through H character
  metrics), deferred list, out-of-scope list.
- Ideas: four exotic enclosure variants with render (steampunk
  chronometer, retro VFD array, minimalist birch e-ink,
  bio-digital cybernetic cluster), metrics brainstorm organised
  in seven categories, hardware / software wild ideas,
  unlikely-but-noted.

Images committed: monitor-dash.png referenced from Home and
Hardware; exotic-dashes.png referenced from Ideas.

2026-04-17 19:30:38 -06:00

Page revisions

2 Commits