--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mupdf-source/docs/tools/mutool-run.rst	Mon Sep 15 11:43:07 2025 +0200
@@ -0,0 +1,81 @@
+mutool run
+==========================================
+
+The ``run`` command executes a Javascript program, which has access to most of the features of the MuPDF library.
+The command supports ECMAScript 5 syntax in strict mode.
+
+.. code-block:: bash
+
+	mutool run script.js [ arguments ... ]
+
+``script.js``
+	The Javascript file which you would like to run.
+
+``[ arguments ... ]``
+	Any extra arguments you want to pass to the script.
+	These are available in the global ``scriptArgs`` array.
+
+If invoked without any arguments, it will drop you into an interactive REPL (read-eval-print-loop).
+To exit call the ``quit()`` function or press *Ctrl-D*.
+
+Environment
+-----------
+
+Command line arguments are accessible from the global ``scriptArgs`` array.
+The name of the script is in the global ``scriptPath`` variable.
+
+The following functions are only available in the mutool run shell:
+
+``require(module)``
+	Load a Javascript module.
+
+``repr(value)``
+	Convert any Javascript value to a string.
+
+``gc(report)``
+	Run the garbage collector to free up memory. Optionally report statistics on the garbage collection.
+
+``load(fileName)``
+	Load and execute script in "fileName".
+
+``print(...)``
+	Print arguments to ``stdout``, separated by spaces and followed by a newline.
+
+``quit()``
+	Exit the shell.
+
+``read(fileName)``
+	Read the contents of a file and return them as a UTF-8 decoded string.
+
+``readFile(fileName)``
+	Read the contents from a file and return them as a Buffer.
+
+``readline()``
+	Read one line of input from standard input and return it as a string.
+
+``write(...)``
+	Print arguments to ``stdout``, separated by spaces.
+
+Node Compatibility
+------------------
+
+For compatibility with Node the following objects are provided:
+
+``process.argv``
+	The command line arguments.
+
+``fs.readFileSync``
+	Read a file into a buffer.
+
+``fs.writeFileSync``
+	Write a buffer to file.
+
+The following ESM import statements are ignored:
+
+.. code-block::
+
+	import * as fs from "fs"
+	import * as mupdf from "mupdf"
+
+If you only use these functions and otherwise stick to ES5 syntax and CommonJS
+imports, your scripts should be able to run both with mutool run and Node.