CLI vẽ biểu đồ trong terminal từ dữ liệu số

TL;DR

Công cụ CLI giúp convert dữ liệu số thành các loại biểu đồ hiển thị trực tiếp trong terminal. Hỗ trợ ascii, spark, bars, columns, heatmap, unicode, braille, svg. Tiện cho dev muốn visualize data nhanh mà không cần mở Excel hay browser.

Nói đơn giản: Gõ lệnh để biến dãy số thành biểu đồ ngay trong cửa sổ terminal.

Bài này dành cho ai?

1. Dev muốn visualize data nhanh trong terminal

Vấn đề: Mỗi lần muốn xem data dạng chart phải mở Excel, Jupyter, hoặc web

Khi nào cần: Khi đang làm việc trong CLI, viết script, hoặc muốn embed chart vào terminal-based dashboard

Được gì: Chart hiện ngay trong terminal, không cần rời khỏi workspace

2. Người viết script tự động hóa

Vấn đề: Cần output dạng visualize để report mà không muốn generate file hình ảnh

Khi nào cần: Khi viết CI/CD pipeline, monitoring script, hoặc automation cần log có chart

Được gì: Generate chart trực tiếp từ dữ liệu text, có thể pipe output sang chỗ khác

Các điểm chính

1. Chạy được ngay không cần cài

Dùng npx chartli là chạy được liền. Hoặc cài global bằng pnpm add -g chartli. → Làm gì: Test ngay bằng câu npx chartli xem nó hiển thị gì.

2. Hỗ trợ 8 loại chart khác nhau

ascii, spark, bars, columns, heatmap, unicode, braille, svg. Mỗi loại phù hợp với use case khác nhau - từ đơn giản đến detailed. → Làm gì: Thử chartli file.txt -t spark để xem sparkline, hoặc -t heatmap cho heatmap.

3. Data input đơn giản - file text chứa số

Đọc từ file hoặc stdin. Format dữ liệu là text thuần, không cần JSON hay CSV phức tạp. → Làm gì: Chuẩn bị file text với các con số, chạy thử xem output như thế nào.

4. Tùy chỉnh được width và height

Dùng -w cho chiều rộng, -h cho chiều cao. Control được kích thước chart theo terminal của mình. → Làm gì: Thử chartli file.txt -t bars -w 28 để xem khác biệt.

5. Export được ra SVG

Dùng -t svg -m lines để generate file SVG, có thể dùng trong report hoặc web. → Làm gì: chartli data.txt -t svg -m lines -w 320 -h 120 > chart.svg

6. Có thể tích hợp vào agent

Install skill cho AI agent bằng npx skills add ahmadawais/chartli. Agent có thể dùng tool này khi cần visualize data. → Làm gì: Nếu xài AI agent, thêm skill này để agent tự vẽ chart khi cần.

Quick Start

1. Chạy thử ngay: npx chartli --help để xem các option
2. Tạo file text đơn giản với vài con số, chạy: npx chartli mydata.txt -t spark
3. Thử các loại chart khác nhau bằng -t ascii, -t bars, -t heatmap