feat: add tvz command alias

Add a second Cargo binary target named tvz that shares the same CLI implementation as termviz.

Document the alias, cover it in CLI and release verification, and include both binaries in release artifacts.

Author: siriusctrl

.github/workflows/ci.yml

@@ -34,11 +34,12 @@ jobs:
         with:
           components: rustfmt
       - run: cargo build --locked --release
-      - name: Package Linux release binary
+      - name: Package Linux release binaries
         run: |
           mkdir -p target/release/dist
           cp target/release/termviz target/release/dist/termviz
-          tar -czf "termviz-linux-x86_64.tar.gz" -C target/release/dist termviz
+          cp target/release/tvz target/release/dist/tvz
+          tar -czf "termviz-linux-x86_64.tar.gz" -C target/release/dist termviz tvz
           sha256sum "termviz-linux-x86_64.tar.gz" > "termviz-linux-x86_64.tar.gz.sha256"
       - uses: actions/upload-artifact@v4
         with:

.github/workflows/release.yml

@@ -59,20 +59,28 @@ jobs:
       - run: cargo clippy --all-targets --locked -- -D warnings
       - run: cargo build --release --locked --target "$LINUX_X64_TARGET"
 
-      - name: Package Linux x64 static binary
+      - name: Package Linux x64 static binaries
         shell: bash
         run: |
           set -euo pipefail
           mkdir -p dist/termviz-linux-x64
           cp "target/$LINUX_X64_TARGET/release/termviz" dist/termviz-linux-x64/
+          cp "target/$LINUX_X64_TARGET/release/tvz" dist/termviz-linux-x64/
           cp "target/$LINUX_X64_TARGET/release/termviz" dist/termviz
+          cp "target/$LINUX_X64_TARGET/release/tvz" dist/tvz
           cp README.md LICENSE dist/termviz-linux-x64/
           file dist/termviz-linux-x64/termviz
+          file dist/termviz-linux-x64/tvz
           if readelf -l dist/termviz-linux-x64/termviz | grep -q "Requesting program interpreter"; then
             echo "Expected a static Linux x64 binary without a glibc runtime dependency." >&2
             exit 1
           fi
+          if readelf -l dist/termviz-linux-x64/tvz | grep -q "Requesting program interpreter"; then
+            echo "Expected a static Linux x64 alias binary without a glibc runtime dependency." >&2
+            exit 1
+          fi
           dist/termviz-linux-x64/termviz --version
+          dist/termviz-linux-x64/tvz --version
           tar -C dist -czf "dist/termviz-linux-x64.tar.gz" termviz-linux-x64
 
       - uses: actions/upload-artifact@v7
@@ -81,6 +89,7 @@ jobs:
           path: |
             dist/termviz-linux-x64.tar.gz
             dist/termviz
+            dist/tvz
 
   github-release:
     runs-on: ubuntu-latest

CHANGELOG.md

@@ -8,6 +8,11 @@ matching `## [X.Y.Z]` section before the release tag is pushed.
 
 ## [Unreleased]
 
+### Added
+
+- Add `tvz` as a short CLI alias installed alongside the existing `termviz`
+  command.
+
 ### Changed
 
 - Remove unused terminal palette/layout modules and keep test-only dependencies

Cargo.toml

@@ -11,6 +11,14 @@ keywords = ["terminal", "image", "plot", "viewer", "cli"]
 categories = ["command-line-utilities", "visualization"]
 exclude = [".github/"]
 
+[[bin]]
+name = "termviz"
+path = "src/bin/termviz.rs"
+
+[[bin]]
+name = "tvz"
+path = "src/bin/tvz.rs"
+
 [dependencies]
 ab_glyph = "0.2.32"
 anyhow = "1.0.102"

README.md

@@ -14,6 +14,13 @@ Install with Cargo:
 cargo install --git https://github.com/siriusctrl/termviz
 ```
 
+This installs both the full command and the short alias:
+
+```sh
+termviz --version
+tvz --version
+```
+
 To install a tagged version:
 
 ```sh
@@ -22,6 +29,7 @@ cargo install --git https://github.com/siriusctrl/termviz --tag v0.2.3
 
 ```sh
 termviz image.png
+tvz image.png
 termviz image.png --inspect
 termviz image.png > frame.png
 termviz image.png --output-format ansi > preview.ansi

docs/INDEX.md

@@ -36,7 +36,8 @@ Read these when the task matches:
 
 Code orientation:
 
-- `src/main.rs` is the thin binary entry point.
+- `src/bin/termviz.rs` and `src/bin/tvz.rs` are thin binary entry points for
+  the full command and short alias.
 - `src/lib.rs` exposes the internal modules used by the binary and tests.
 - `src/cli.rs` wires CLI arguments to input profile detection, inspection,
   export, and viewer dispatch.

docs/releasing.md

@@ -76,9 +76,10 @@ Before publishing:
 ## Release Artifacts
 
 Release artifacts are a Linux x64 static binary tarball plus SHA-256 checksum.
-The release workflow verifies that the binary has no glibc runtime interpreter
-before packaging, so Linux x64 users can download a self-contained CLI from the
-GitHub Release page.
+The tarball contains both `termviz` and the `tvz` short alias. The release
+workflow verifies that neither binary has a glibc runtime interpreter before
+packaging, so Linux x64 users can download a self-contained CLI from the GitHub
+Release page.
 
 ## Install From Git
 
@@ -87,6 +88,7 @@ The supported package-manager-free install path is Cargo from GitHub:
 ```sh
 cargo install --git https://github.com/siriusctrl/termviz --tag vX.Y.Z
 termviz --version
+tvz --version
 ```
 
 For local validation before tagging, run `scripts/release-verify.sh`. The script

scripts/release-verify.sh

@@ -20,6 +20,7 @@ cargo package --locked --allow-dirty
 printf 'Building release binary for smoke checks...\n'
 cargo build --quiet --locked --release
 BIN="${REPO_ROOT}/target/release/termviz"
+SHORT_BIN="${REPO_ROOT}/target/release/tvz"
 
 tmp_dir="$(mktemp -d)"
 trap 'rm -rf "$tmp_dir"' EXIT
@@ -34,6 +35,9 @@ EOF
 
 printf 'Running CLI smoke checks...\n'
 
+"$BIN" --version | grep -q "termviz"
+"$SHORT_BIN" --version | grep -q "termviz"
+
 "$BIN" examples/inspect-square.png --inspect > "${tmp_dir}/inspect-png.out"
 grep -q "content=Png" "${tmp_dir}/inspect-png.out"
 grep -q "shape=RasterImage" "${tmp_dir}/inspect-png.out"

src/main.rs src/bin/termviz.rssrc/main.rs renamed to src/bin/termviz.rs

@@ -0,0 +1,3 @@
+fn main() -> anyhow::Result<()> {
+    termviz::cli::run()
+}