chartli

chartli Skill

Use this skill when an agent needs to visualize numeric data in the terminal as ASCII/Unicode/SVG charts.

Install

npx skills add ahmadawais/chartli

CLI install/use

Instant use:

npx chartli --help

Global install:

npm i -g chartli

What chartli can do

• Render chart types: ascii, spark, bars, columns, heatmap, unicode, braille, svg
• Read from file path input
• Read from stdin when no file is passed
• Control output dimensions with --width and --height
• Render SVG with --mode circles|lines
• Add x and y axis titles with --x-axis-label and --y-axis-label
• Add custom tick/category labels with --x-labels and --series-labels
• Show raw values on the plotted data with --data-labels
• Promote the first numeric column into x-axis labels with --first-column-x

Command templates

From file:

From stdin:

Labeled two-column chart:

Per-type examples:

Input format

Whitespace-separated numeric rows; optional header row is allowed.

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.

Repository example assets

• examples/assets/core-single-series.txt
• examples/assets/core-multi-series.txt
• examples/assets/image-data.txt
• examples/assets/image-columns-variant.txt