Skip to content

Terminal Recordings

asciinema

Use asciinema for real terminal sessions. The recording is text-based and can be embedded in docs with the asciinema player.

asciinema rec docs/demos/casts/first-proof.cast
python3 -m ait.cli demo full-agent-mesh --scenario content_rewrite --trials 1
exit

To embed a committed cast in a docs page:

<div id="first-proof-cast"></div>
<script>
  AsciinemaPlayer.create('../casts/first-proof.cast', document.getElementById('first-proof-cast'));
</script>

VHS

Use VHS when the demo should be scripted and reproducible.

vhs docs/demos/vhs/first-proof.tape

The first tape should show a short terminal path:

  1. run ait demo
  2. inspect the run
  3. serve the cockpit
  4. show the report path and key verdict

Guidance

  • Keep terminal recordings short.
  • Prefer deterministic local runs.
  • Do not record live model output by default.
  • Re-record after CLI output changes.