qf-studio/grom

grom turns Prometheus metrics into dashboards you view directly in your terminal, styled the way system monitors like btop are, with charts drawn from braille characters, gradient meters, and stats colored by threshold. Instead of building a new dashboard from scratch, you can point grom at an existing Grafana dashboard JSON export and it will recreate the same layout and panels in the terminal. The author built this because the closest prior tool for Grafana-style terminal dashboards, grafterm, has been unmaintained since 2019 and only supports a fixed set of widgets, while btop itself only shows system metrics rather than data from Prometheus. grom aims to fill that gap by rendering your own Prometheus queries, whether written by hand in a small YAML config or imported from Grafana. In the YAML config format, each widget such as a stat, gauge, bar gauge, or time series chart is defined with one or more PromQL queries plus how to present the result: a unit, optional sparkline, threshold colors, and a position in a 24 column grid similar to Grafana's own layout system. If you skip the grid settings, grom automatically arranges widgets into responsive rows based on how wide your terminal is. When importing a real Grafana dashboard, grom maps supported panel types one to one, respects field configuration like units and thresholds, and shows a placeholder with a warning for anything it cannot translate. You can run it against any Prometheus server using just its built in metrics, try a demo mode with fake data and no Prometheus required, or output a single static frame for scripts, cron jobs, or documentation snapshots. It runs entirely in the terminal, uses full color when your terminal supports it, and falls back to plain ASCII blocks if your font lacks braille character support. This is aimed at developers and operations engineers who already use Prometheus and Grafana and want a fast way to check dashboards over SSH or in a terminal without opening a browser. It is released under the MIT license and is still described as an early release under active development.