docs(cli) Show every command in action

why: Give readers a concrete view of each command beside its reference.

what:
- Embed the agg-rendered GIF for each top-level command
- Show list tree mode in its existing reference section
- Replace and remove the legacy homepage recording
- Rebuild published docs when rendered GIFs change

Author: tony

.github/workflows/docs.yml

@@ -30,6 +30,7 @@ jobs:
               - README.*
             docs:
               - 'docs/**'
+              - 'docs/_static/demos/asciinema/*.gif'
               - 'examples/**'
             python_files:
               - 'src/vcspull/**'

docs/_static/vcspull-demo.gif

@@ -15,6 +15,12 @@ For bulk import from remote services ([GitHub](https://github.com),
 [GitLab](https://gitlab.com), etc.), see {ref}`cli-import`.
 ```
 
+```{image} ../_static/demos/asciinema/vcspull-add.gif
+:alt: vcspull add registering a repository from its checkout
+:width: 100%
+:loading: lazy
+```
+
 ## Command
 
 ```{eval-rst}

docs/cli/add.md

@@ -7,6 +7,12 @@ The `vcspull discover` command scans directories for existing
 {ref}`configuration <configuration>`. This is ideal for importing existing
 workspaces or migrating from other tools.
 
+```{image} ../_static/demos/asciinema/vcspull-discover.gif
+:alt: vcspull discover scanning a directory tree for repositories
+:width: 100%
+:loading: lazy
+```
+
 ## Command
 
 ```{eval-rst}

docs/cli/discover.md

@@ -11,6 +11,12 @@ single section so repositories are never dropped. Prefer to review duplicates
 without rewriting them? Pass `--no-merge` to leave the original sections in
 place while still showing a warning.
 
+```{image} ../_static/demos/asciinema/vcspull-fmt.gif
+:alt: vcspull fmt previewing a normalized configuration
+:width: 100%
+:loading: lazy
+```
+
 ## Command
 
 ```{eval-rst}

docs/cli/fmt.md

@@ -13,6 +13,12 @@ Supported services: **[GitHub](https://github.com)**,
 **[Gitea](https://about.gitea.com/)**, **[Forgejo](https://forgejo.org)**, and
 **[AWS CodeCommit](https://aws.amazon.com/codecommit/)**.
 
+```{image} ../../_static/demos/asciinema/vcspull-import.gif
+:alt: vcspull import fetching repositories from a remote service
+:width: 100%
+:loading: lazy
+```
+
 ## Command
 
 ```{eval-rst}

docs/cli/import/index.md

@@ -7,6 +7,12 @@ The `vcspull list` command displays configured repositories from your vcspull
 verify your configuration,
 filter repositories by patterns, and export structured data for automation.
 
+```{image} ../_static/demos/asciinema/vcspull-list.gif
+:alt: vcspull list showing configured repositories
+:width: 100%
+:loading: lazy
+```
+
 ## Command
 
 ```{eval-rst}
@@ -62,6 +68,12 @@ $ vcspull list --tree
   • flask → ~/code/flask
 ```
 
+```{image} ../_static/demos/asciinema/vcspull-list-tree.gif
+:alt: vcspull list grouping repositories by workspace
+:width: 100%
+:loading: lazy
+```
+
 ## JSON output
 
 Export repository information as JSON for automation and tooling:

docs/cli/list.md

@@ -12,6 +12,12 @@ These keys shipped at the entry root in vcspull v1.61.0. They are still read,
 but {ref}`cli-sync` warns when it encounters them. Migrating clears the warning
 and keeps configs on the supported shape.
 
+```{image} ../_static/demos/asciinema/vcspull-migrate.gif
+:alt: vcspull migrate previewing configuration schema changes
+:width: 100%
+:loading: lazy
+```
+
 ## Command
 
 ```{eval-rst}

docs/cli/migrate.md

@@ -7,6 +7,12 @@ The `vcspull search` command looks up repositories across your vcspull
 [rg](https://github.com/BurntSushi/ripgrep)-like query syntax. Queries are regex by default, can
 scope to specific fields, and can emit structured JSON for automation.
 
+```{image} ../_static/demos/asciinema/vcspull-search.gif
+:alt: vcspull search narrowing a set of repositories to matches
+:width: 100%
+:loading: lazy
+```
+
 ## Command
 
 ```{eval-rst}

docs/cli/search.md

@@ -7,6 +7,12 @@ showing which repositories exist on disk, which are missing, and their
 [Git](https://git-scm.com/) status. This introspection command helps verify
 your local workspace matches your {ref}`configuration <configuration>`.
 
+```{image} ../_static/demos/asciinema/vcspull-status.gif
+:alt: vcspull status reporting clean, dirty, and missing repositories
+:width: 100%
+:loading: lazy
+```
+
 ## Command
 
 ```{eval-rst}