# Reel CLI

> The reel command records terminals and renders recordings without Go. It runs VHS tapes, tests with tapes, records commands, drives programs in detached sessions for scripts and agents, and turns asciicast files into GIFs, videos, and stills.

This is one section of the documentation for steep, reel, and the reel CLI. [The overview](https://getsteep.dev/llms.txt) says which to use.

## Start here

- [Introduction](https://getsteep.dev/cli.md): Install the reel command, and record terminals and render recordings without writing Go.
- [Quickstart](https://getsteep.dev/cli/quickstart.md): Record a command, render it differently, and pull out a screenshot.

## Guides

- [Tapes](https://getsteep.dev/cli/tapes.md): Script a recording with a VHS tape, every command and setting a tape can use, and coming from VHS.
- [Test with tapes](https://getsteep.dev/cli/test.md): Run tapes as tests, with waits and golden files, no code needed.
- [Record your terminal](https://getsteep.dev/cli/record.md): Record a command or your shell as you use it, or render a recording from script(1).
- [Edit existing recordings](https://getsteep.dev/cli/edit-recordings.md): Render, cut, screenshot, and convert asciicast files, from reel, steep, or asciinema.
- [Drive programs from scripts and agents](https://getsteep.dev/cli/sessions.md): Run a program in a detached terminal, and control it one command at a time.

## Features

- [Appearance](https://getsteep.dev/cli/appearance.md): Title bars, keys, toasts, themes, and fonts, turned on and off with flags.
- [Effects](https://getsteep.dev/cli/effects.md): Cards, pauses, cuts, highlights, zooms, and redaction, from flags.
- [Outputs](https://getsteep.dev/cli/outputs.md): Choosing formats with -o, their options, and path variables.

## Commands

- [reel run](https://getsteep.dev/cli/commands/run.md): Run VHS tapes and write their outputs.
- [reel test](https://getsteep.dev/cli/commands/test.md): Run tapes as tests.
- [reel rec](https://getsteep.dev/cli/commands/rec.md): Record a command, or your shell, in this terminal.
- [reel session](https://getsteep.dev/cli/commands/session.md): Drive a program in a detached, recorded terminal, one command at a time.
- [reel export](https://getsteep.dev/cli/commands/export.md): Render an asciicast file through reel's renderer and effects.
- [reel still](https://getsteep.dev/cli/commands/still.md): Render one moment of an asciicast file.
- [reel cut](https://getsteep.dev/cli/commands/cut.md): Cut an asciicast file down to the window between two marks.
- [reel convert](https://getsteep.dev/cli/commands/convert.md): Convert an asciicast file between versions 2 and 3.
- [reel attach](https://getsteep.dev/cli/commands/attach.md): Render a script(1) typescript.
- [reel play](https://getsteep.dev/cli/commands/play.md): Replay an asciicast file in this terminal.
- [reel info](https://getsteep.dev/cli/commands/info.md): Describe an asciicast file.
- [reel themes](https://getsteep.dev/cli/commands/themes.md): List the named themes.
- [reel fonts](https://getsteep.dev/cli/commands/fonts.md): List the font families reel can draw with.

## Help

- [Troubleshooting](https://getsteep.dev/cli/troubleshooting.md): Common errors from the reel command, and how to fix them.

## Reference

- [Configuration and exit codes](https://getsteep.dev/cli/configuration.md): Flags, environment variables, and tape settings, which one wins, and what the exit codes mean.

## Optional

- [Everything](https://getsteep.dev/llms-full.txt): every page of the site, as one file