Copy-paste embeds for terminal recordings
Atmos can record a terminal session as an asciicast (
.cast) file: a lightweight, text-based replay you can commit beside the documentation and examples it demonstrates. It is a practical way to show teammates exactly how to run a workflow, rather than describing every command in prose.Atmos Pro brings those recordings to life from a public GitHub repository as an animated, shareable player—or as GIF, MP4, SVG, and WEBM artifacts when you need them. The Cast URL Builder and every cast's player page now generate ready-to-paste HTML and Markdown embed snippets, so the same runnable example can live in your docs, blog, or README.
See a cast in action
This is a live Atmos terminal recording embedded directly from the
cloudposse/atmos repository. Press play, drag the scrubber, or open it to view the full player.Interactive HTML embed
For a site that supports iframes, use the HTML snippet. It embeds the animated player directly, including its playback controls and scrubber.
<iframe
src="https://atmos-pro.com/casts/cloudposse/atmos/54a79c02979aadeccad730910cb6ffbce6639976/website/static/casts/examples/quick-start-simple/list-and-plan.cast"
title="Atmos Cast"
width="960"
height="540"
style="border:0;max-width:100%;aspect-ratio:16/9"
allow="clipboard-write"
loading="lazy"
></iframe>Markdown for GitHub
GitHub does not permit iframe embeds in Markdown, so its snippet uses a GIF image that links to the interactive player. It is a compatibility fallback and does not include playback controls or scrubbing.
[](https://atmos-pro.com/casts/cloudposse/atmos/54a79c02979aadeccad730910cb6ffbce6639976/website/static/casts/examples/quick-start-simple/list-and-plan.cast)Copy a snippet from a real cast's player page and it's automatically pinned to the exact commit the recording came from, so the embed is cached for a year and never silently changes underneath you. See Embed a Cast on Your Site or README for the full walkthrough, including how to trade permanence for an embed that tracks a branch's latest recording.