Skip to content

Docs: animated SVG demo in README (v0.8.2)#21

Merged
DrBaher merged 1 commit into
mainfrom
claude/asciinema-demo
May 17, 2026
Merged

Docs: animated SVG demo in README (v0.8.2)#21
DrBaher merged 1 commit into
mainfrom
claude/asciinema-demo

Conversation

@DrBaher
Copy link
Copy Markdown
Owner

@DrBaher DrBaher commented May 17, 2026

Summary

Adds an animated SVG demo to the README, embedded between the intro paragraph and the "Run this" section. Matches nda-review-cli's pattern of placing the cast immediately before the first command. Self-contained: ~11 KB SVG, plays inline on github.com and npmjs.com without an asciinema.org dependency.

What's in the cast

7.7-second loop showing the three-step flow against the Common Paper Mutual NDA fixture in examples/:

  1. draft --version
  2. draft --list-placeholders examples/cp-mutual-nda-coverpage.md
  3. draft examples/cp-mutual-nda-coverpage.md --purpose ... --diff

How it was generated

  • asciinema 3.2.0 records a scripted run in headless mode
  • v3 cast → v2 cast conversion script (svg-term-cli only handles v1/v2 format)
  • npx svg-term-cli renders to a self-contained animated SVG with standard terminal-window chrome

Test plan

  • npm test — no test changes
  • CI green
  • After merge + tag v0.8.2: ship via NPM_TOKEN; the npmjs.com README will then show the demo embed

🤖 Generated with Claude Code

Adds assets/demo.svg — a self-contained animated terminal cast
(~11 KB) showing the three-step flow against the Common Paper
Mutual NDA cover page fixture in examples/:

  1. draft --version
  2. draft --list-placeholders examples/cp-mutual-nda-coverpage.md
  3. draft examples/cp-mutual-nda-coverpage.md \
       --purpose ... --effective-date ... --term ... \
       --governing-state ... --jurisdiction ... --diff

Generated via:
  1. asciinema 3.2.0 records the script in headless mode
  2. v3 cast → v2 cast conversion script
  3. svg-term-cli renders to a self-contained animated SVG with
     the standard terminal-window chrome

Embedded between the intro paragraph and "Run this" section,
matching nda-review-cli's placement of its asciinema cast.

Self-contained means no asciinema.org hosting dependency — the
SVG plays inline on github.com and npmjs.com (which both pull
images from the GitHub raw URL when assets/ isn't shipped in the
npm package).

Strictly docs + assets; no code or test changes.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@DrBaher DrBaher merged commit 7945185 into main May 17, 2026
8 checks passed
@DrBaher DrBaher deleted the claude/asciinema-demo branch May 17, 2026 08:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant