diff --git a/docs/fish-config.1 b/docs/fish-config.1
index 6b7cf56..b794991 100644
--- a/docs/fish-config.1
+++ b/docs/fish-config.1
@@ -1968,13 +1968,14 @@ replay \[dq]export FOO=bar\[dq]
 Synopsis:  kitty-logging [install|uninstall|status|dismiss] [-h]
 
 Manages the Kitty scrollback watcher that powers C5 logging. Ships a
-canonical, version-marked watcher and installs it into the Kitty config
-directory, wiring it into kitty.conf through a sentinel-marked managed
-block. Commenting out any conflicting watcher line avoids double-capture.
+canonical watcher and symlinks it into the Kitty config directory (so it
+always tracks the source), wiring it into kitty.conf through a
+sentinel-marked managed block. Commenting out any conflicting watcher line
+avoids double-capture.
 
 Commands:
-  install    Copy/refresh the watcher and add the managed block
-  uninstall  Remove the managed block and the watcher file
+  install    Symlink the watcher and add the managed block
+  uninstall  Remove the managed block and the watcher symlink
   status     Show wiring, installed watcher version, and C5 state
   dismiss    Stop the per-session setup reminder
 
@@ -2469,9 +2470,9 @@ To guarantee a zellij pane is logged, end the session with
 \f[V]exit\f[R] or Ctrl-D rather than zellij\[cq]s close-pane or quit
 actions.
 .PP
-The Kitty watcher is managed by the kitty-logging command: it installs a
-version-marked watcher (fish-config-watcher.py) into the Kitty config
-directory and wires it into kitty.conf via a managed block.
+The Kitty watcher is managed by the kitty-logging command: it symlinks
+the watcher (fish-config-watcher.py) into the Kitty config directory and
+wires it into kitty.conf via a managed block.
 Inside Kitty, a non-blocking per-session reminder points first-time
 users at \f[V]kitty-logging install\f[R] until they install or run
 \f[V]kitty-logging dismiss\f[R].
diff --git a/docs/html/11-7-customization.html b/docs/html/11-7-customization.html
index 2f37362..785b9a4 100644
--- a/docs/html/11-7-customization.html
+++ b/docs/html/11-7-customization.html
@@ -785,10 +785,10 @@ guarantee a zellij pane is logged, end the session with
 <code>exit</code> or Ctrl-D rather than zellij's close-pane or quit
 actions.</p>
 <p>The Kitty watcher is managed by the kitty-logging command: it
-installs a version-marked watcher (fish-config-watcher.py) into the
-Kitty config directory and wires it into kitty.conf via a managed block.
-Inside Kitty, a non-blocking per-session reminder points first-time
-users at <code>kitty-logging install</code> until they install or run
+symlinks the watcher (fish-config-watcher.py) into the Kitty config
+directory and wires it into kitty.conf via a managed block. Inside
+Kitty, a non-blocking per-session reminder points first-time users at
+<code>kitty-logging install</code> until they install or run
 <code>kitty-logging dismiss</code>. Install affects new Kitty windows
 only; runtime disable is still handled by the .logging_disabled
 sentinel.</p>
diff --git a/docs/html/9-5-functions-reference.html b/docs/html/9-5-functions-reference.html
index 9d23ff7..1a556e1 100644
--- a/docs/html/9-5-functions-reference.html
+++ b/docs/html/9-5-functions-reference.html
@@ -1339,13 +1339,14 @@ replay &quot;export FOO=bar&quot;</code></pre>
 <pre><code>Synopsis:  kitty-logging [install|uninstall|status|dismiss] [-h]
 
 Manages the Kitty scrollback watcher that powers C5 logging. Ships a
-canonical, version-marked watcher and installs it into the Kitty config
-directory, wiring it into kitty.conf through a sentinel-marked managed
-block. Commenting out any conflicting watcher line avoids double-capture.
+canonical watcher and symlinks it into the Kitty config directory (so it
+always tracks the source), wiring it into kitty.conf through a
+sentinel-marked managed block. Commenting out any conflicting watcher line
+avoids double-capture.
 
 Commands:
-  install    Copy/refresh the watcher and add the managed block
-  uninstall  Remove the managed block and the watcher file
+  install    Symlink the watcher and add the managed block
+  uninstall  Remove the managed block and the watcher symlink
   status     Show wiring, installed watcher version, and C5 state
   dismiss    Stop the per-session setup reminder
 
diff --git a/docs/wiki/5-functions-reference.md b/docs/wiki/5-functions-reference.md
index 4e412a6..c72b16a 100644
--- a/docs/wiki/5-functions-reference.md
+++ b/docs/wiki/5-functions-reference.md
@@ -1050,13 +1050,14 @@
     Synopsis:  kitty-logging [install|uninstall|status|dismiss] [-h]
 
     Manages the Kitty scrollback watcher that powers C5 logging. Ships a
-    canonical, version-marked watcher and installs it into the Kitty config
-    directory, wiring it into kitty.conf through a sentinel-marked managed
-    block. Commenting out any conflicting watcher line avoids double-capture.
+    canonical watcher and symlinks it into the Kitty config directory (so it
+    always tracks the source), wiring it into kitty.conf through a
+    sentinel-marked managed block. Commenting out any conflicting watcher line
+    avoids double-capture.
 
     Commands:
-      install    Copy/refresh the watcher and add the managed block
-      uninstall  Remove the managed block and the watcher file
+      install    Symlink the watcher and add the managed block
+      uninstall  Remove the managed block and the watcher symlink
       status     Show wiring, installed watcher version, and C5 state
       dismiss    Stop the per-session setup reminder