# chartli
> Render charts in your terminal from numeric text data

## Summary
CLI for rendering terminal charts from numeric text data — supports ASCII, sparklines, bars, columns, heatmaps, Unicode, Braille, and SVG output.

## Capabilities
- Render ASCII line charts
- Generate sparklines from data
- Draw horizontal bar and vertical column charts
- Create heatmaps
- Unicode block character rendering
- Braille pattern charts
- SVG output (circles or lines mode)
- Read from files or stdin

## When to Use
- You need quick data visualization in the terminal
- You want to chart numeric data from a pipeline
- You need SVG chart output from the command line

## When NOT to Use
- You need interactive or web-based dashboards
- You need non-numeric chart types

## Key Flags
- `-t, --type`: Chart type: ascii, sparkline, bar, column, heatmap, unicode, braille, svg
- `-w, --width`: Chart width
- `-h, --height`: Chart height

## Usage Patterns
### Chart from stdin
```
echo '1 5 3 9 2 7' | chartli -t sparkline
```
Render a sparkline from piped data

### Bar chart from file
```
chartli -t bar data.txt
```
Render a horizontal bar chart from a file

### SVG output
```
chartli -t svg data.txt > chart.svg
```
Generate SVG chart and save to file

## Input / Output
- **stdin**: Numeric text data (space or newline separated)
- **stdout**: Rendered chart (ASCII, Unicode, or SVG)

## Installation
- **npm**: `npm install -g chartli`
- **npx**: `npx chartli --help`

---
Source: https://littlescripts.sh/tools/chartli