fp.

termstage lets you describe a terminal session in YAML and renders it as an animated SVG — lightweight, crisp at any size, embeds directly in GitHub READMEs.

Example:

  steps:
    - cmd: "notes list"
      output: "#1  Fix the login bug"
    - cmd: "notes done 1"
      output: "Marked #1 as done"

Run `termstage render demo.yaml --animated` and you get an SVG you can drop anywhere.

Install: pipx install termstage

GitHub: https://github.com/saikatkumardey/termstage PyPI: https://pypi.org/project/termstage/

Comments

lazystone•1h ago

> I was tired of screen-recording CLI demos

What was wrong with https://asciinema.org/ ?

saikatkumardey•1h ago

Nothing, honestly. asciinema needs a JS player to render, GitHub READMEs don't support it as a native image. termstage outputs plain SVG, so it's just an <img> tag that works anywhere.