hty replay

Re-feed recorded output events through a fresh in-memory VT engine and render the result in your terminal. You see the session play back exactly as it appeared when it ran, including color, cursor movement, and full-screen TUI frames.

Replay has no side effects. It does not re-run the program, does not touch the original log file, and does not send any input.

Reference

hty replay [SESSION] [--speed Nx] [--at T] [--to T] [--loop]

Replay a session by reading its log file and feeding the recorded
output bytes back through a fresh in-memory VT engine. The program
is NOT re-executed and no input is re-sent — replay is a pure
visualization with zero side effects.

Flags:
  --speed Nx   Playback speed multiplier (default 1x). 0 = no sleep.
  --at T       Fast-forward silently to T into the session before
               painting (same duration syntax as --since).
  --to T       Stop painting once the timeline reaches T.
  --loop       Restart playback from the beginning when the log ends.

Press Ctrl-C or Ctrl-Q to exit.

Examples

# Replay at normal speed
hty replay my-session
 
# Replay at 3x speed
hty replay my-session --speed 3
 
# Jump to a time range
hty replay my-session --at 5s --to 10s
 
# Loop continuously
hty replay my-session --loop