Allow specifying watchers in session files and via a command line argument

docs/changelog.rst

@@ -21,6 +21,9 @@ To update |kitty|, :doc:`follow the instructions <binary>`.
 
 - Allow tracking focus change events in watchers (:iss:`2918`)
 
+- Allow specifying watchers in session files and via a command line argument
+  (:iss:`2933`)
+
 
 0.18.3 [2020-08-11]
 -------------------

docs/index.rst

@@ -353,6 +353,15 @@ For example:
     focus
     launch emacs
 
+    # Add a watcher that will be called with various events that occur
+    # on all subsequent windows. See the documentation of the launch command
+    # for details on watchers.
+    watcher /some/python/file.py
+    launch mpd
+    launch irssi
+    # Remove the watcher for further windows
+    watcher clear
+
 
 Mouse features
 -------------------