diff --git a/docs/antora/modules/command-line/pages/command_line_tools.adoc b/docs/antora/modules/command-line/pages/command_line_tools.adoc
index 00bb070fe3..ad22b6dd53 100644
--- a/docs/antora/modules/command-line/pages/command_line_tools.adoc
+++ b/docs/antora/modules/command-line/pages/command_line_tools.adoc
@@ -199,6 +199,9 @@ usage: ChronicleReaderMain
  -w <wire-type>       Control output i.e. JSON
 ----
 
+The `-n` option accepts both decimal and hexadecimal indexes, making it easy to replay specific offsets.
+When `-r` is provided you can also add `-g` to include the queue's `MessageHistory` records in the output.
+
 == ChronicleWriterMain
 
 `ChronicleWriterMain` can be used to write to a queue, using a method writer to write the contents of files provided.
@@ -224,6 +227,8 @@ usage: ChronicleWriterMain
  -m <method>      Method name
 ----
 
+Multiple YAML documents can be supplied on the same command line; they are written to the queue in the order supplied so you can batch up related method calls.
+
 == DumpMain
 
 `DumpMain` takes a single parameter indicating the path to dump text from.
diff --git a/docs/utilities.adoc b/docs/utilities.adoc
index 59ba27f2ce..9ecc726fde 100644
--- a/docs/utilities.adoc
+++ b/docs/utilities.adoc
@@ -158,7 +158,10 @@ Created /tmp/chronicle-queue-tools.tar
 
 The resulting `tar` file can be copied to another location, and expanded.
 Once unpacked, invoke the `queue_reader.sh` script in order to execute the
-`InternalChronicleReader` utility:
+`InternalChronicleReader` utility. Recent releases honour the same options as the Maven runner:
+- pass `-n <index>` (decimal or hex) to resume reading from a specific index
+- use `-l` to flatten multi-line payloads into a single line for easier log scraping
+- combine `-r <interface>` with `-g` to include `MessageHistory` alongside MethodWriter traffic
 
 [source,bash]
 ....