diff --git a/kitty/cli.py b/kitty/cli.py
index 1e3e49bd2..c899acdf8 100644
--- a/kitty/cli.py
+++ b/kitty/cli.py
@@ -113,7 +113,10 @@ Output commands received from child process to stdout
 
 --replay-commands
 type=bool-set
-Replay previously dumped commands
+Replay previously dumped commands. Specify the path to a dump file previously created by --dump-commands. You
+can open a new kitty window to replay the commands with:
+
+    kitty sh -c "kitty --replay-commands /path/to/dump/file; read"
 
 
 --dump-bytes