docs: switch CLI demo to headless manual-typing gif pipeline

Author: Your Name

MEMORY.md

@@ -412,3 +412,25 @@
 
 - `git push origin main` ✅
 - remote update range: `2f6b849..1b201f2` ✅
+
+## 2026-02-27 (Headless GIF Re-record)
+
+### Progress
+
+- Re-recorded CLI demo GIF with headless terminal rendering to avoid desktop interference.
+- Installed required tooling for headless flow:
+  - `vhs` (via `go install`)
+  - `ttyd` (via `scoop install ttyd`)
+- Added reusable tape-based recording assets:
+  - `docs/scripts/cicost_manual_typing.tape`
+  - `docs/scripts/record_cli_gif_headless.ps1`
+- Removed aborted desktop-injection attempt scripts:
+  - deleted `docs/scripts/manual_type_session.ps1`
+  - deleted `docs/scripts/record_cli_gif_manual.ps1`
+- Updated README demo script reference to the new headless recorder.
+
+### Validation
+
+- `vhs docs/scripts/cicost_manual_typing.tape` ✅
+- `docs/assets/cicost-cli-demo.gif` regenerated ✅
+- `go test ./...` ✅

README.md

@@ -116,7 +116,7 @@ go build -o cicost .
 - Operations runbook: [RUNBOOK.md](RUNBOOK.md)
 - Release process: [docs/RELEASE.md](docs/RELEASE.md)
 - Launch kit: [docs/LAUNCH.md](docs/LAUNCH.md)
-- Demo recording script: `docs/scripts/record_cli_gif.ps1`
+- Demo recording script (headless): `docs/scripts/record_cli_gif_headless.ps1`
 - Technical specs: [TECHNICAL_SPEC_V1.md](TECHNICAL_SPEC_V1.md), [TECHNICAL_SPEC_V2.md](TECHNICAL_SPEC_V2.md)
 
 ## Community and Trust

docs/assets/cicost-cli-demo.gif

@@ -0,0 +1,33 @@
+Output docs/assets/cicost-cli-demo.gif
+
+Set Shell "pwsh"
+Set FontSize 18
+Set Width 1100
+Set Height 700
+Set Framerate 30
+Set Theme "Builtin Solarized Dark"
+Set Padding 20
+
+Type "cd 'C:\\AI Projects\\Fun Stuff\\IndieHacker\\CICost'"
+Enter
+Sleep 700ms
+
+Type "go build -o cicost.exe ."
+Enter
+Sleep 1500ms
+
+Type ".\\cicost.exe version"
+Enter
+Sleep 1200ms
+
+Type ".\\cicost.exe help"
+Enter
+Sleep 1400ms
+
+Type ".\\cicost.exe policy explain"
+Enter
+Sleep 1500ms
+
+Type ".\\cicost.exe report --repo owner/repo --days 7 --format table"
+Enter
+Sleep 1800ms

docs/scripts/cicost_manual_typing.tape

@@ -0,0 +1,26 @@
+param(
+  [string]$Tape = "docs/scripts/cicost_manual_typing.tape"
+)
+
+$ErrorActionPreference = "Stop"
+
+Set-Location (Resolve-Path (Join-Path $PSScriptRoot "..\.."))
+
+$vhs = Join-Path $env:USERPROFILE "go\bin\vhs.exe"
+if (-not (Test-Path $vhs)) {
+  Write-Host "Installing vhs..." -ForegroundColor Yellow
+  go install github.com/charmbracelet/vhs@latest
+}
+
+if (-not (Get-Command ttyd -ErrorAction SilentlyContinue)) {
+  Write-Host "Installing ttyd..." -ForegroundColor Yellow
+  scoop install ttyd
+}
+
+Write-Host "Building cicost.exe..." -ForegroundColor Yellow
+go build -o cicost.exe .
+
+Write-Host "Rendering GIF from tape (headless)..." -ForegroundColor Yellow
+& $vhs $Tape
+
+Write-Host "Done." -ForegroundColor Green