diff --git a/POC/.gitignore b/POC/.gitignore
index c1d9e9c..dfa5f7f 100644
--- a/POC/.gitignore
+++ b/POC/.gitignore
@@ -12,9 +12,8 @@ bundle/
 *.tar.gz
 bitwarden-logs-*.zip
 
-# Local answer files may hold installation id/key
-answers.yaml
-answers.yml
+# Local install manifests
+bitwarden.yaml
 
 # Secrets / certs
 *.pfx
diff --git a/POC/bwsh/README.md b/POC/bwsh/README.md
index cdbe48d..37b4304 100644
--- a/POC/bwsh/README.md
+++ b/POC/bwsh/README.md
@@ -4,6 +4,8 @@ A single .NET tool that installs and manages a Bitwarden self-host deployment 
 `bitwarden.sh` + `run.sh` + Setup-container stack. It generates all config in-process and drives
 Docker directly. Supports both **standard** and **lite** deployments.
 
+![bwsh status](docs/images/status.gif)
+
 > Status: working proof of concept. See **What's not done yet** at the bottom.
 
 ## Prerequisites
@@ -25,6 +27,8 @@ dotnet run -- install
 It asks for your domain, region, installation id/key, and database name, then pulls the images,
 starts the stack, and shows a live status table.
 
+![bwsh install](docs/images/install.gif)
+
 ### Unattended with a manifest
 
 Create `bitwarden.yaml`:
@@ -76,6 +80,7 @@ dotnet run -- migrate --root ./bwdata
 - Versions default to the pinned `version.json` release; override per run with
   `update --core-version <v> --web-version <v>` or in the manifest.
 - A real `bwsh` binary can be produced with `dotnet publish -c Release --self-contained`.
+- The demo GIFs are generated from VHS tapes in [`docs/`](docs/README.md).
 
 ## What's not done yet
 
diff --git a/POC/bwsh/docs/images/install.gif b/POC/bwsh/docs/images/install.gif
new file mode 100644
index 0000000..1ffef3f
Binary files /dev/null and b/POC/bwsh/docs/images/install.gif differ
diff --git a/POC/bwsh/docs/images/logs.gif b/POC/bwsh/docs/images/logs.gif
new file mode 100644
index 0000000..e800f24
Binary files /dev/null and b/POC/bwsh/docs/images/logs.gif differ
diff --git a/POC/bwsh/docs/images/status.gif b/POC/bwsh/docs/images/status.gif
new file mode 100644
index 0000000..1835735
Binary files /dev/null and b/POC/bwsh/docs/images/status.gif differ
diff --git a/POC/bwsh/docs/install.tape b/POC/bwsh/docs/install.tape
new file mode 100644
index 0000000..31edd34
--- /dev/null
+++ b/POC/bwsh/docs/install.tape
@@ -0,0 +1,29 @@
+# bwsh install — live progress table marching to healthy.
+# Render from POC/bwsh/:  vhs docs/install.tape   (setup: docs/README.md)
+# Pre-pull the images first so the GIF shows orchestration, not downloads.
+
+Output docs/images/install.gif
+
+Require bwsh
+
+Set Shell "bash"
+Set FontSize 16
+Set Width 1000
+Set Height 460
+Set Padding 24
+Set TypingSpeed 60ms
+Set WindowBar Colorful
+Set BorderRadius 8
+Set Theme "Dracula"
+
+Hide
+Type "export PS1='$ '"
+Enter
+Type "clear"
+Enter
+Show
+
+Type "bwsh install --manifest bitwarden.yaml"
+Sleep 700ms
+Enter
+Sleep 90s   # pulling -> creating -> starting -> healthy, then the vault URL
diff --git a/POC/bwsh/docs/logs.tape b/POC/bwsh/docs/logs.tape
new file mode 100644
index 0000000..3a38e50
--- /dev/null
+++ b/POC/bwsh/docs/logs.tape
@@ -0,0 +1,33 @@
+# bwsh logs — per-service logs + the --export support bundle.
+# Render from POC/bwsh/:  vhs docs/logs.tape   (setup: docs/README.md)
+
+Output docs/images/logs.gif
+
+Require bwsh
+
+Set Shell "bash"
+Set FontSize 16
+Set Width 1200
+Set Height 800
+Set Padding 24
+Set TypingSpeed 60ms
+Set WindowBar Colorful
+Set BorderRadius 8
+Set Theme "Dracula"
+
+Hide
+Type "export PS1='$ '"
+Enter
+Type "clear"
+Enter
+Show
+
+Type "bwsh logs identity -d lite"
+Sleep 700ms
+Enter
+Sleep 3s
+
+Type "bwsh logs --export support-bundle.zip -d lite"
+Sleep 700ms
+Enter
+Sleep 3s
diff --git a/POC/bwsh/docs/status.tape b/POC/bwsh/docs/status.tape
new file mode 100644
index 0000000..42f592a
--- /dev/null
+++ b/POC/bwsh/docs/status.tape
@@ -0,0 +1,29 @@
+# bwsh status — health table, versions, vault URL.
+# Render from POC/bwsh/:  vhs docs/status.tape   (setup: docs/README.md)
+
+Output docs/images/status.gif
+
+Require bwsh
+
+Set Shell "bash"
+Set FontSize 16
+Set Width 900
+Set Height 620
+Set Padding 24
+Set TypingSpeed 60ms
+Set WindowBar Colorful
+Set BorderRadius 8
+Set Theme "Dracula"
+
+# Clean prompt so the recording shows the tool, not the shell.
+Hide
+Type "export PS1='$ '"
+Enter
+Type "clear"
+Enter
+Show
+
+Type "bwsh status -d lite"
+Sleep 700ms
+Enter
+Sleep 5s