# great-docs termshow record


Record a terminal session to a .termshow file.


``` bash
great-docs termshow record [OPTIONS] OUTPUT
```


Spawns an interactive shell and captures all output with timing. Press Ctrl+D or type `exit` to stop recording.


<span class="gd-details-chevron" aria-hidden="true"></span>Full --help output


    Usage: great-docs termshow record [OPTIONS] OUTPUT

      Record a terminal session to a .termshow file.

      Spawns an interactive shell and captures all output with timing. Press
      Ctrl+D or type 'exit' to stop recording.

    Options:
      --cols INTEGER   Terminal width in columns
      --rows INTEGER   Terminal height in rows
      --shell TEXT     Shell to spawn (default: $SHELL)
      --capture-input  Also capture keyboard input events
      --help           Show this message and exit.


# Arguments


`OUTPUT: PATH`  
Required.


# Options


`--cols: INTEGER`  
Terminal width in columns

`--rows: INTEGER`  
Terminal height in rows

`--shell: TEXT`  
Shell to spawn (default: \$SHELL)

`--capture-input`  
Also capture keyboard input events