Skip to content
Data
Skill

/chartli

Install and use chartli to render terminal charts from numeric text files or stdin.

From plugin
chartli
8081 skill

Claude Code

$ npx -y skills add ahmadawais/chartli --skill chartli --agent claude-code

SKILL.md

chartli.SKILL.md
name: chartli
description: Install and use chartli to render terminal charts from numeric text files or stdin.

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:

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

Input format

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.

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`
Read more
Stats
810
Stars
47
Forks
Quiet
Maintenance
TypeScript
Language
Last commit
Created

Repo: ahmadawais/chartli

@ahmadawais
Ships withchartli

CLI for rendering charts in terminals from numeric text data. chartli turns plain numbers into terminal charts. ascii, spark, bars, columns, heatmap, unicode, braille, svg.

Stars on GitHub

Momentum

stars in total
808
Star history of ahmadawais/chartli on GitHub, a chart by star-history.com

More skills from other plugins.

context-loader
Auto-invoked

context-loader

Search memories from earlier Pi sessions in this repository. Use it when earlier work may already explain the code, error,…

mem08d69k
@mem0ai@mem0aiInstall Skill
analyzing-ai-citations

analyzing-ai-citations

Answer AI citation and answer engine optimization (AEO) questions in PostHog: whether AI answer engines (ChatGPT, Claude, and an…

posthog2w41k
@posthog@posthogInstall Skill

Questions about chartli.

Which coding agents can use chartli?
chartli installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.