chore(docs): regenerate man page, HTML docs, and wiki

docs/fish-config.1

@@ -96,6 +96,7 @@ conf.d/
   first_run.fish          One-time init: Fisher bootstrap, theme, welcome
   key_bindings.fish       Custom key bindings and Vi mode
   logging-events.fish     C5 --on-variable event handlers; syncs logging state at startup
+  kitty-watcher-reminder.fish  C5 per-session reminder to set up the Kitty watcher
   paru-wrapper.fish       Auto-generates \[ti]/.local/bin/paru logging wrapper
   puffer.fish             !! / !$ / ./ expansion (bundled from nickeb96/puffer-fish)
   tmux-logging.fish       C5 starts tmux pipe-pane capture when fish runs inside tmux
@@ -1769,6 +1770,32 @@ replay \[dq]source \[ti]/.bashrc\[dq]
 replay \[dq]export FOO=bar\[dq]
 \f[R]
 .fi
+.SS kitty-logging
+.IP
+.nf
+\f[C]
+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.
+
+Commands:
+  install    Copy/refresh the watcher and add the managed block
+  uninstall  Remove the managed block and the watcher file
+  status     Show wiring, installed watcher version, and C5 state
+  dismiss    Stop the per-session setup reminder
+
+Runtime capture stays governed by the C5 .logging_disabled sentinel, so
+disabling __fish_config_op_logging makes the watcher inert without
+uninstalling. Install affects new Kitty windows only.
+
+Example:
+  kitty-logging install
+  kitty-logging status
+\f[R]
+.fi
 .SS tmux-clean
 .IP
 .nf
@@ -2184,6 +2211,15 @@ Because the capture happens at exit, toggling __fish_config_op_logging
 takes effect on the next exit with no restart or sentinel coordination
 needed \[em] the C5 guard is re-checked when the handler fires.
 .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.
+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].
+Install affects new Kitty windows only; runtime disable is still handled
+by the .logging_disabled sentinel.
+.PP
 Logging coordination via sentinel file
 .PP
 C5 uses a sentinel file to synchronize state between the shell and

docs/html/11-7-customization.html

@@ -727,6 +727,14 @@ and then prunes old zellij_*.log files the same way. Because the capture
 happens at exit, toggling __fish_config_op_logging takes effect on the
 next exit with no restart or sentinel coordination needed — the C5 guard
 is re-checked when the handler fires.</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
+<code>kitty-logging dismiss</code>. Install affects new Kitty windows
+only; runtime disable is still handled by the .logging_disabled
+sentinel.</p>
 <p>Logging coordination via sentinel file</p>
 <p>C5 uses a sentinel file to synchronize state between the shell and
 out-of-process components (the Kitty watcher and all running

docs/html/3-description.html

@@ -526,6 +526,7 @@ conf.d/
   first_run.fish          One-time init: Fisher bootstrap, theme, welcome
   key_bindings.fish       Custom key bindings and Vi mode
   logging-events.fish     C5 --on-variable event handlers; syncs logging state at startup
+  kitty-watcher-reminder.fish  C5 per-session reminder to set up the Kitty watcher
   paru-wrapper.fish       Auto-generates ~/.local/bin/paru logging wrapper
   puffer.fish             !! / !$ / ./ expansion (bundled from nickeb96/puffer-fish)
   tmux-logging.fish       C5 starts tmux pipe-pane capture when fish runs inside tmux

docs/html/9-5-functions-reference.html

@@ -1174,17 +1174,38 @@ Fish session. Useful for sourcing Bash scripts.
 
 replay "source ~/.bashrc"
 replay &quot;export FOO=bar&quot;</code></pre>
-<h3 data-number="9.14.12" id="tmux-clean">tmux-clean</h3>
+<h3 data-number="9.14.12" id="kitty-logging">kitty-logging</h3>
+<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.
+
+Commands:
+  install    Copy/refresh the watcher and add the managed block
+  uninstall  Remove the managed block and the watcher file
+  status     Show wiring, installed watcher version, and C5 state
+  dismiss    Stop the per-session setup reminder
+
+Runtime capture stays governed by the C5 .logging_disabled sentinel, so
+disabling __fish_config_op_logging makes the watcher inert without
+uninstalling. Install affects new Kitty windows only.
+
+Example:
+  kitty-logging install
+  kitty-logging status</code></pre>
+<h3 data-number="9.14.13" id="tmux-clean">tmux-clean</h3>
 <pre><code>Synopsis:  tmux-clean
 Kills all detached (unattached) tmux sessions, leaving attached ones
 running.</code></pre>
-<h3 data-number="9.14.13" id="wake-lock">wake-lock</h3>
+<h3 data-number="9.14.14" id="wake-lock">wake-lock</h3>
 <pre><code>Synopsis:  wake-lock &lt;command&gt; [args...]
 Runs a command under systemd-inhibit, preventing the system from going
 idle or sleeping until the command completes.
 
 wake-lock rsync -avz src/ dest/</code></pre>
-<h3 data-number="9.14.14" id="zellij">zellij</h3>
+<h3 data-number="9.14.15" id="zellij">zellij</h3>
 <pre><code>Synopsis:  zellij [args...]
 Launches zellij with the Catppuccin Mocha theme applied.</code></pre>
 <hr />

docs/html/index.html

@@ -791,6 +791,8 @@ id="toc-joplin">joplin</a></li>
 id="toc-ld-1">ld</a></li>
 <li><a href="9-5-functions-reference.html#replay"
 id="toc-replay">replay</a></li>
+<li><a href="9-5-functions-reference.html#kitty-logging"
+id="toc-kitty-logging">kitty-logging</a></li>
 <li><a href="9-5-functions-reference.html#tmux-clean"
 id="toc-tmux-clean">tmux-clean</a></li>
 <li><a href="9-5-functions-reference.html#wake-lock"

docs/wiki/5-functions-reference.md

@@ -879,6 +879,29 @@
     replay "source ~/.bashrc"
     replay "export FOO=bar"
 
+### kitty-logging
+
+    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.
+
+    Commands:
+      install    Copy/refresh the watcher and add the managed block
+      uninstall  Remove the managed block and the watcher file
+      status     Show wiring, installed watcher version, and C5 state
+      dismiss    Stop the per-session setup reminder
+
+    Runtime capture stays governed by the C5 .logging_disabled sentinel, so
+    disabling __fish_config_op_logging makes the watcher inert without
+    uninstalling. Install affects new Kitty windows only.
+
+    Example:
+      kitty-logging install
+      kitty-logging status
+
 ### tmux-clean
 
     Synopsis:  tmux-clean

docs/wiki/7-customization.md

@@ -265,6 +265,13 @@ at exit, toggling __fish_config_op_logging takes effect on the next exit with
 no restart or sentinel coordination needed — the C5 guard is re-checked when
 the handler fires.
 
+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 `kitty-logging install` until
+they install or run `kitty-logging dismiss`. Install affects new Kitty windows
+only; runtime disable is still handled by the .logging_disabled sentinel.
+
 Logging coordination via sentinel file
 
 C5 uses a sentinel file to synchronize state between the shell and

docs/wiki/index.md

@@ -37,6 +37,7 @@ The configuration is split across:
       first_run.fish          One-time init: Fisher bootstrap, theme, welcome
       key_bindings.fish       Custom key bindings and Vi mode
       logging-events.fish     C5 --on-variable event handlers; syncs logging state at startup
+      kitty-watcher-reminder.fish  C5 per-session reminder to set up the Kitty watcher
       paru-wrapper.fish       Auto-generates ~/.local/bin/paru logging wrapper
       puffer.fish             !! / !$ / ./ expansion (bundled from nickeb96/puffer-fish)
       tmux-logging.fish       C5 starts tmux pipe-pane capture when fish runs inside tmux