The `glab` README and main docs page currently include an animated GIF showing basic CLI usage. The existing recording is outdated and shows no meaningful output. There is also no documented process for updating it, no stored source for the animation, and no clear home in the project for demo assets. This issue proposes adopting [VHS by Charmbracelet](https://github.com/charmbracelet/vhs) to manage terminal recordings as code. VHS uses `.tape` files (plain text scripts) to produce GIF/MP4/WebP output deterministically. Since `glab` already uses Charm libraries, this is a natural fit. Storing tape files in the repository makes recordings reviewable, diffable, and reproducible by anyone with VHS installed. ## Proposed work - Add a `demos/` directory to the repository as the canonical home for `.tape` files and their generated output - Add a `demos/README.md` documenting how to install VHS, run a tape, and contribute new recordings - Replace the existing blank GIF in the README and docs with a new recording produced from a tape file, showing `glab repo clone` and `glab issue list` as a starting point - Establish `gitlab.com/phikai/glab-demo` as the fixture project used in demo recordings (public, stable, purpose-built) - Evaluate whether GIF regeneration can be automated in CI using the [VHS Docker image](https://github.com/charmbracelet/vhs#docker) Once this foundation is in place, individual commands and workflows can each get their own tape, making it straightforward to keep docs visually current as the CLI evolves.