Record Terminal Sessions With asciinema

Capture a full terminal session as a tiny, text-based .cast file.

macOSTerminalscriptingLow risk

Run asciinema rec demo.cast, do your work, then type exit to stop recording.

01Command

Command

$ asciinema rec demo.cast

02What it does

asciinema records terminal input, output and timing into a small JSON-based .cast file rather than a heavy video. Replay it with asciinema play demo.cast, or upload it to asciinema.org for an embeddable player. It is ideal for bug reports and tutorials.

03Risk

RiskLow risk

Requirementsbrew install asciinema

CompatibilitymacOS with Homebrew installed

!Warning: Everything typed is recorded, including secrets; review the cast before sharing it.

04Undo

Undo

$ exit

05Sources

Homebrew formula: asciinema
Homebrew · vendor-doc · 2026-09-20
Evidence: Installs the asciinema recorder and player.
asciinema documentation
asciinema · vendor-doc · 2026-09-20
Evidence: Official docs for recording and replaying .cast sessions.

Last verified: 2026-09-20 · Category: Developer

06Related solutions

Change where screenshots are saved on Mac

macOSScreenshotTerminaldefaults

Point macOS screen captures at any folder you choose instead of the desktop.

Medium risk ✓ 2026-09-16

Download a file from a URL on Mac with curl

macOSTerminal

Grab any file from the web straight into the current folder — no browser needed.

Low risk ✓ 2026-09-16

Find files larger than 500 MB on Mac

macOSFilesTerminal

List the biggest files in your home folder that are eating disk space.

Low risk ✓ 2026-09-16