commit 0287d300c262d5078fdb930576a23e680c1c07dd
parent dd4ccccd4c4fde9d0a3765c71a457f61214edf74
Author: Erik Loualiche <eloualic@umn.edu>
Date: Fri, 3 Apr 2026 19:34:06 -0500
docs: hero GIF at top, individual GIFs in each tool section
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Diffstat:
4 files changed, 47 insertions(+), 12 deletions(-)
diff --git a/README.md b/README.md
@@ -6,18 +6,7 @@
[](https://claude.ai)
[](LICENSE)
-<table>
-<tr>
-<td align="center" width="33%"><strong>dtcat</strong> — view</td>
-<td align="center" width="33%"><strong>dtfilter</strong> — query</td>
-<td align="center" width="33%"><strong>dtdiff</strong> — compare</td>
-</tr>
-<tr>
-<td><img src="demo/dtcat.gif" alt="dtcat demo" /></td>
-<td><img src="demo/dtfilter.gif" alt="dtfilter demo" /></td>
-<td><img src="demo/dtdiff.gif" alt="dtdiff demo" /></td>
-</tr>
-</table>
+<img src="demo/hero.gif" alt="dt-cli-tools demo" width="80%" />
</div>
@@ -81,6 +70,8 @@ Requires Rust 1.85+.
## dtcat — View Data Files
+<img src="demo/dtcat.gif" alt="dtcat demo" width="80%" />
+
```bash
# Overview: schema + data (<=50 rows all, >50 head/tail 25)
dtcat data.parquet
@@ -145,6 +136,8 @@ Modes `--schema`, `--describe`, `--info`, and data (default) are mutually exclus
## dtfilter — Query and Filter
+<img src="demo/dtfilter.gif" alt="dtfilter demo" width="80%" />
+
```bash
# Filter rows by value
dtfilter data.csv --filter State=CA
@@ -191,6 +184,8 @@ dtfilter data.parquet --filter value>0 --csv
## dtdiff — Compare Two Files
+<img src="demo/dtdiff.gif" alt="dtdiff demo" width="80%" />
+
```bash
# Positional diff (whole-row comparison)
dtdiff old.csv new.csv
diff --git a/demo/hero.gif b/demo/hero.gif
Binary files differ.
diff --git a/demo/hero.tape b/demo/hero.tape
@@ -0,0 +1,40 @@
+# VHS tape for recording hero demo GIF — one quick example of each tool.
+# Usage: vhs demo/hero.tape
+#
+# Prerequisites:
+# - dtcat, dtfilter, dtdiff binaries built and in PATH
+# - Demo files in demo/
+
+Output demo/hero.gif
+
+Set FontSize 14
+Set Width 1100
+Set Height 550
+Set Padding 15
+Set Theme "GruvboxDarkHard"
+
+Set TypingSpeed 80ms
+
+Set Shell "bash"
+
+Hide
+ Type 'export PS1="> "'
+ Enter
+ Type "clear"
+ Enter
+Show
+
+# ─── VIEW ───
+Type "dtcat demo/sales.xlsx --head 5"
+Enter
+Sleep 3s
+
+# ─── FILTER ───
+Type "dtfilter demo/sales.xlsx --filter Region=East --sort Revenue:desc --limit 3"
+Enter
+Sleep 3s
+
+# ─── DIFF ───
+Type "dtdiff demo/old.xlsx demo/new.xlsx --key ID"
+Enter
+Sleep 4s
diff --git a/demo/sales.xlsx b/demo/sales.xlsx
Binary files differ.