claude-gauge/README.md
Jeff Smith a683828e6b Initial scaffold
Project skeleton for claude-gauge: a hardware instrument cluster and
companion web dashboard driven by a local Python daemon that tails
~/.claude/projects/**/*.jsonl.

Includes:
- PLAN.md with cluster layout, dashboard sections, architecture,
  metrics brainstorm, and phasing.
- README.md overview.
- Python package scaffold (src/claude_gauge), pyproject.toml
  targeting Python 3.12+ and uv, MIT LICENSE, standard gitignore.

No runtime code yet. Phase A (daemon MVP) will land under the
first issue.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-17 19:01:30 -06:00

19 lines
696 B
Markdown

# claude-gauge
Hardware instrument cluster plus companion web dashboard for Claude
Code session telemetry.
A local Python daemon tails `~/.claude/projects/**/*.jsonl`, parses
structured events into rolling windows and aggregate stats, and
exposes them over HTTP. An ESP32 or Pi Pico drives a three-gauge
analog cluster on the desk (tokens/min tach, 5h fuel, 7d fuel) with
an annunciator row of model and warning lamps. A browser dashboard
on the same port surfaces the deep stats.
See [PLAN.md](PLAN.md) for architecture, the instrument cluster
layout, the dashboard sections, the full metrics brainstorm, and
the phasing plan.
## Status
Scaffolded. Phase A (daemon MVP) is the first issue.