cast-record

Capture a real terminal session — authentic output, colors, and timing — into an asciicast .cast file (newline-delimited JSON) with asciinema 3.x. The cast is the text-native source of truth: replayable in the terminal, diffable, and renderable later. Recording is local-first: nothing uploads unless you explicitly run asciinema upload.

When NOT to use

• A polished, scripted README demo with simulated typing → tape-demo (nothing real needs capturing).
• Turning an existing .cast into GIF/MP4 → cast-render.
• Removing sensitive data from a recording → cast-redact.
• Hosting, streaming, or embedding the asciinema web player → out of scope.

Workflow