Getting started

1. Install the recorder

Install asciinema with:

brew install asciinema

See other installation options.

2. Record

To start recording run the following command:

asciinema rec

This spawns a new shell instance and records all terminal output. When you're ready to finish simply exit the shell either by typing exit or hitting Ctrl-D.

See usage instructions to learn about all commands and options.

3. Manage your recordings (optional)

If you want to manage your recordings on asciinema.org (set title/description, delete etc) you need to authenticate. Run the following command and open displayed URL in your web browser:

asciinema auth

If you skip this step now, you can run the above command later and all previously recorded asciicasts will automatically get assigned to your profile.