Tier: Beginner
Every qsv command, grouped by category. This page is the index โ each row links to the category page (workflow-level discussion + non-trivial real-world example) and to the canonical per-command help in /docs/help/ (flags, arguments, full examples).
The exact set of commands in your binary depends on the variant and its enabled feature flags โ run qsv --list to see what's available.
Note
How to read this table. The category page tells you when to reach for a command and how it composes. The /docs/help/<cmd>.md page tells you exactly which flags exist . Use both. Since 24.0.0 the binary can also print it: qsv <command> --help --format md (help Markdown) or --format json (a JSON tool definition) โ see AI & Documentation .
Commands inherit symbols from the README legend . The most useful ones to know:
๐ Faster with an index. Create one with qsv index <file>.
๐ Multithreaded by default (even without an index).
๐๏ธ Multithreaded when an index exists.
๐ปโโ๏ธ Powered/accelerated by Polars.
๐คฏ Loads entire file into memory (consider streaming alternatives for huge files).
๐ช "Automagical" โ uses the stats / frequency cache to work smarter.
๐ Supports runtime lookup tables.
๐ Has remote / URL options.
๐ฃ Requires UTF-8 input.
๐ Has the powerful column selector syntax โ see select .
โจ Behind a feature flag โ see Binary Variants and docs/FEATURES.md .
Daily-driver commands for looking at and slicing a CSV.
Command
Symbols
One-liner
Help
headers
๐๏ธ
Show column names (and union across many files)
docs/help
count
๐๐ปโโ๏ธ๐๏ธ
Row count (instant with an index)
docs/help
sample
๐๐๏ธ๐
Random sample with 10 methods (reservoir, indexed, bernoulli, systematic, stratified, weighted, varopt, mergeable-reservoir, cluster, timeseries); mergeable sketch I/O
docs/help
slice
๐๐๏ธ๐๏ธ
Slice by row range
docs/help
select
๐
Pick / re-order / drop columns
docs/help
search
๐๐๏ธ๐
Filter rows by regex
docs/help
searchset
๐๐๏ธ๐
Run many regexes in a single pass (PII scanning)
docs/help
flatten
Show one record per line (vertical view)
docs/help
table
๐คฏ
Elastic-tab table view + leftendtab / Fixed-Width output
docs/help
color
โจ๐คฏ๐ปโโ๏ธ๐ฅ๏ธ
Colorized table โ type-coded, terminal-fit, light/dark theme auto
docs/help
lens
โจ๐๏ธ๐ปโโ๏ธ๐ฅ๏ธ
Interactive viewer (csvlens) โ CSV, Parquet, Arrow, JSONL
docs/help
clipboard
โจ๐ฅ๏ธ
Read from / write to OS clipboard
docs/help
sniff
๐๐ค๐
Infer delimiter, headers, schema, MIME type โ even for remote files
docs/help
Clean, rename, sort, reshape โ the pre-analysis layer.
Numbers, distributions, dedup, ext-* commands.
Combine, exclude, partition, split.
Command
Symbols
One-liner
Help
join
๐๐ฃ๐
In-memory inner/outer/cross/anti/semi joins
docs/help
joinp
โจ๐ปโโ๏ธ๐๐ช
Polars-powered: non-equi, asof, larger-than-RAM
docs/help
exclude
๐๐
Remove rows of one CSV from another
docs/help
partition
๐
Split into one file per value of a column
docs/help
split
๐๐๏ธ
Split by rows / chunks / size (multithreaded with index)
docs/help
Polars LazyFrame, SQL, pivots, score-before-run.
Command
Symbols
One-liner
Help
sqlp
โจ๐๐๏ธ๐ปโโ๏ธ๐๐ช
Polars SQL across CSVs/Parquet/JSONL/Arrow
docs/help
joinp
โจ๐ปโโ๏ธ๐๐ช
Polars joins (see Joins category)
docs/help
pivotp
โจ๐ปโโ๏ธ๐๐ช
Pivot with smart aggregation auto-selection
docs/help
scoresql
โจ๐ปโโ๏ธ๐ช
Score a SQL query BEFORE running it (Polars / DuckDB modes)
docs/help
Infer, validate, sniff.
Command
Symbols
One-liner
Help
validate
๐๐๏ธ๐๐๐
JSON Schema 2020-12 validation (up to 780k rows/sec)
docs/help
schema
๐๐ฃ๐ปโโ๏ธ๐๏ธ๐๐ช
Infer JSON Schema 2020-12 or Polars schema
docs/help
profile
โจ๐๐ง ๐ค๐ช๐๐โฉ๏ธ
Profile a CSV โ DCAT-US v3 / DCAT-AP v3 / Croissant / Geoconnex / CKAN metadata (FAIRification)
docs/help
sniff
๐๐ค๐
Quick metadata inference (see Selection category)
docs/help
Move between formats: Parquet, Excel, ODS, SAS/Stata/SPSS, JSON, JSONL, SQLite, Postgres, GeoJSON, Snappy.
Command
Symbols
One-liner
Help
excel
๐
Export Excel/ODS sheets to CSV
docs/help
readstat
โจ๐คฏ๐ปโโ๏ธ๐
SAS/Stata/SPSS โ CSV โ codes by default, --value-labels to decode, --metadata to dump the variable metadata, --dictionary to write a JSON Schema data dictionary (24.0.0); streams except SPSS portable .por, which is read whole (new in 23.0.1)
docs/help
writestat
โจ๐คฏ๐ปโโ๏ธ
CSV โ SPSS (.sav/.por), Stata (.dta) or SAS transport (.xpt); with a readstat --dictionary, restores labels & missing values (new in 24.0.0)
docs/help
to
โจ๐๏ธ๐ปโโ๏ธ๐
CSV โ Parquet, SQLite, Postgres, Excel, ODS, Data Package
docs/help
json
๐
JSON array โ CSV
docs/help
jsonl
๐๐ฃ
JSONL โ CSV
docs/help
tojsonl
๐๐ฃ๐๏ธ๐๐ฃ๐ช
CSV โ JSONL with smart type inference
docs/help
snappy
๐๐
Streaming Snappy compress/decompress
docs/help
geoconvert
โจ๐
Spatial formats โ CSV (GeoJSON, SHP, SVGโฆ)
docs/help
prompt
โจ๐ปโโ๏ธ๐ฅ๏ธ
OS file-picker dialog
docs/help
clipboard
โจ๐ฅ๏ธ
OS clipboard I/O (see Selection category)
docs/help
Command
Symbols
One-liner
Help
geocode
โจ๐๐ง ๐๐๐ฃ๐๐
Forward / reverse geocode โ offline (Geonames + Maxmind), 360k/sec, or online via the OpenCage API
docs/help
geoconvert
โจ๐
Spatial format conversions
docs/help
Command
Symbols
One-liner
Help
viz
โจ๐ช๐
Interactive Plotly charts (bar/line/scatter/scatter3d/histogram/box/violin/pie/heatmap/contour/candlestick/ohlc/sankey/ radar/treemap/sunburst/icicle/splom/parcats/funnel/map/geo/choropleth) + a smart auto-dashboard that produces a Data Schematic
docs/help
Command
Symbols
One-liner
Help
get
โจ๐
Fetch local/URL/CKAN/cloud data into a managed disk cache (delimiter sniffing, glob batch fetch, --sample preview); read back via the dc: prefix
docs/help
fetch
โจ๐๐ง ๐
HTTP GET per row, HTTP/2 flow control, jaq, Redis/disk cache
docs/help
fetchpost
โจ๐๐ง ๐โฉ๏ธ
HTTP POST per row, MiniJinja body templating
docs/help
Command
Symbols
One-liner
Help
luau
โจ๐๐๐ฃ๐
Luau 0.720 DSL: BEGIN/MAIN/END, lookup tables, random access
docs/help
py
โจ๐๐ฃ
Python expression per row (requires Python 3.10+)
docs/help
foreach
โจ
Run a shell command per row
docs/help
template
๐๐๐ฃ๐โฉ๏ธ
MiniJinja-render CSV rows into any text format
docs/help
Performance primitives.
Command
Symbols
One-liner
Help
index
Build an index for instant random access
docs/help
clean
Remove qsv-generated cache files (index/stats/frequency; --stale, --dry-run default)
docs/help
diff
๐
Diff two CSVs (1M ร 9 in <600 ms); --drop-equal-columns to focus on what changed
docs/help
blake3
๐
BLAKE3 hash for cache keys / pipeline gating
docs/help
extsort
๐๐๐
External merge sort (see Aggregation category)
docs/help
extdedup
๐
On-disk dedup (see Aggregation category)
docs/help
snappy
๐๐
Streaming Snappy compression (see Conversion category)
docs/help
Command
Symbols
One-liner
Help
describegpt
๐๐๏ธ๐ค๐๐ช๐โฉ๏ธ
Neuro-symbolic data dictionary + SQL RAG via any OpenAI-compatible LLM; Markdown/JSON/TOON/JSONSchema/SemanticMd output
docs/help
synthesize
โจ๐๐ค๐ช
Generate a statistically-faithful synthetic CSV from a source CSV (20.1.0+)
docs/help
Command
One-liner
help
Show qsv's top-level usage (run qsv help or qsv --help)