[rich-iannone]

This PR adds great-docs termshow import-tape demo.tape [OUTPUT], which converts a VHS tape into a .termshow.yml script with record: and steps:, so VHS users can move their demos over in one command. Typing, key presses (with counts and speeds), Ctrl/Alt letter combinations, sleeps, waits (including +Screen and @timeout), Hide/Show, and Copy/Paste become steps. A Type + Enter + Wait in a row becomes a single run. Env and the shell, typing-speed, and wait settings go in record, and themes (built-in names or a JSON color set), the window bar, line height, font, and playback speed go in settings.

The script keeps VHS's > prompt, and shells start without their startup files, so a tape's waits behave as they do in VHS. Commands with no equivalent (Output, Screenshot, Source, Require, pixel sizes, and settings that only change how VHS draws the video) are listed with line numbers in the output and in a comment at the top of the script, --record records the result straight away, and the user guide gets a side-by-side example that a test keeps in sync with the converter.

[github-actions]

📚 Preview this PR's docs locally

Fetch the just-built site and open it in your browser:

# this exact build
great-docs preview --run 40591395653

# or always the latest build for this PR
great-docs preview --pr 458

Auth & tips

• Requires great-docs: pip install great-docs (or run via pipx/uvx).
• Auth: run gh auth login then add --use-gh, or set GITHUB_TOKEN (needs Actions: read).
• Jump to a page: add --path reference/index.html.
• Latest vs exact: --pr <n> grabs the newest build; --run <id> pins this one.
• Re-download: --refresh ignores the local cache.