// Install and use chartli to render terminal charts from numeric text files or stdin.
| name | chartli |
| description | Install and use chartli to render terminal charts from numeric text files or stdin. |
Use this skill when an agent needs to visualize numeric data in the terminal as ASCII/Unicode/SVG charts.
npx skills add ahmadawais/chartli
Instant use:
npx chartli --help
Global install:
npm i -g chartli
ascii, spark, bars, columns, heatmap, unicode, braille, svg--width and --height--mode circles|linesx and y axis titles with --x-axis-label and --y-axis-label--x-labels and --series-labels--data-labels--first-column-xFrom file:
npx chartli <file> -t <type> [--width N] [--height N] [--mode circles|lines] [--x-axis-label LABEL] [--y-axis-label LABEL] [--x-labels a,b,c] [--series-labels foo,bar] [--data-labels] [--first-column-x]
From stdin:
printf 'x y\n1 10\n2 20\n3 15\n' | npx chartli -t ascii -w 24 -h 8
Labeled two-column chart:
printf 'day value\n1 10\n2 20\n3 15\n' | npx chartli -t ascii -w 24 -h 8 --first-column-x --data-labels
Per-type examples:
npx chartli data.txt -t ascii -w 24 -h 8
npx chartli data.txt -t spark
npx chartli data.txt -t bars -w 28
npx chartli data.txt -t columns -h 8
npx chartli data.txt -t heatmap
npx chartli data.txt -t unicode
npx chartli data.txt -t braille -w 16 -h 6
npx chartli data.txt -t svg -m lines -w 320 -h 120
Whitespace-separated numeric rows; optional header row is allowed.
day sales costs profit
1 10 8 2
2 14 9 5
3 12 11 3
When --first-column-x is set, the first numeric column becomes the x-axis labels. If a header row exists, chartli uses the first header cell as the x-axis title and the remaining headers as series labels. For common two-column input, the second header cell becomes the y-axis title.
examples/assets/core-single-series.txtexamples/assets/core-multi-series.txtexamples/assets/image-data.txtexamples/assets/image-columns-variant.txt