guptarohit/asciigraph

asciigraph is a Go package for rendering lightweight ASCII line graphs in command-line applications with no external dependencies.

The tool solves the problem of visualizing time-series data in terminal environments where graphical output is unavailable or impractical. It works by accepting numeric data points and rendering them as ASCII art using box-drawing characters. The package supports single and multiple data series, custom Y-axis formatting for domain-specific units, labeled X-axes with configurable tick marks, and colored output for visual distinction between series.

The tool suits developers building CLI applications, monitoring utilities, or log analysis tools that need quick inline visualization. It is particularly valuable in server environments, CI/CD pipelines, and remote terminals where rendering actual graphics is not feasible. The package offers gradient coloring that maps values to a spectrum palette, threshold-based coloring to highlight values above or below critical points, and legend support for multi-series graphs. A companion CLI utility is also provided for direct command-line use, accepting data via stdin for real-time graphing of streaming data.

The project maintains a straightforward scope focused on ASCII rendering without scope creep into unrelated features. Pull requests are actively welcomed and the contribution process is informal. The codebase remains minimal and dependency-free, reflecting a commitment to simplicity and portability across different Go environments.