Repolode
Submit
ahmadawais

ahmadawais/chartli

A CLI that renders terminal charts (ASCII, sparklines, bars, columns, heatmaps, braille, SVG) from plain numeric text input.

View on GitHubWebsite
Stars
805
Forks
47
Open issues
0
Last commit
7 months ago

What is it?

chartli is a command-line tool that turns numeric text data into charts you can view directly in a terminal. It reads from a file or stdin, so it fits into shell pipelines where numbers come from scripts, logs or other commands.

The tool supports several chart types: ASCII line charts, sparklines, horizontal bars, vertical columns, heatmaps, Unicode block charts, braille plots, and SVG output. Options control width and height, SVG mode (circles or lines), axis titles, tick and series labels, and inline data labels. A --first-column-x flag treats the first numeric column as x-axis labels, which suits data keyed by day, month or year.

chartli can be run without installing via npx, installed globally from npm, or added as an agent skill.

Key features

  • 01Renders ASCII, sparkline, bar, column, heatmap, Unicode, braille and SVG charts.
  • 02Reads numeric data from a file or from stdin.
  • 03Supports axis titles, custom tick labels and series labels.
  • 04Can print raw values on or near plotted data.
  • 05Treats the first numeric column as x-axis labels for time-based data.

Use cases

  • Quickly visualizing numbers from a shell pipeline or log output without opening a spreadsheet.
  • Adding small charts to terminal-based reports or CI output.
  • Generating SVG charts from data files for documentation.

Quick start

  1. 1

    Run instantly without installing

    npx chartli --help
  2. 2

    Or install globally

    npm i -g chartli
  3. 3

    Render a chart from stdin or a file

    npx chartli

Things to know

  • The registry metadata lists no license, although the README states Apache-2.0.
  • Several README examples use pnpm and sample data files, so they require cloning the repository.

Topics

#cli#terminal#charts#data-visualization#ascii#svg#typescript

FAQ

What is chartli?
A CLI that renders terminal charts (ASCII, sparklines, bars, columns, heatmaps, braille, SVG) from plain numeric text input. chartli is a command-line tool that turns numeric text data into charts you can view directly in a terminal. It reads from a file or stdin, so it fits into shell pipelines where numbers come from scripts, logs or other commands.
Is chartli free to use? What license does it have?
chartli has no declared license. Its code is public, but without a license you have no explicit permission to reuse it; ask the author before relying on it.
Is chartli still maintained?
No commits for 6+ months. The last commit to chartli was on Mar 11, 2026.
What can I use chartli for?
Quickly visualizing numbers from a shell pipeline or log output without opening a spreadsheet. Adding small charts to terminal-based reports or CI output. Generating SVG charts from data files for documentation.
How do I install chartli?
Run instantly without installing: npx chartli --help Or install globally: npm i -g chartli Render a chart from stdin or a file: npx chartli
Where can I get chartli?
The source code and installation instructions are on GitHub: https://github.com/ahmadawais/chartli

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects