diff --git a/docs/fish-config.1 b/docs/fish-config.1
index cffa76f..877382d 100644
--- a/docs/fish-config.1
+++ b/docs/fish-config.1
@@ -1778,7 +1778,7 @@ Do not commit fish_variables.
 .SS Opinionated Components (Minimal Mode)
 .PP
 Every opinionated piece of this config is active by default but can be
-switched off through five category opt-out variables, each evaluated via
+switched off through six category opt-out variables, each evaluated via
 __fish_variable_check.
 Set a variable to any falsy value (0, false, no, off, n) to disable its
 category; erase it or set a truthy value (1, true, yes, on, y) to
@@ -1815,6 +1815,12 @@ __fish_config_op_logging        Logging & capture: scrollback
                                 wrappers, Kitty watcher capture;
                                 sentinel file coordinates
                                 cross-process state
+__fish_config_op_greeting       Greeting & first-run UI: per-session
+                                fish_greeting override (defines empty
+                                function late in config.fish to
+                                suppress distro greetings such as
+                                CachyOS fastfetch); first-run welcome
+                                banner in conf.d/first_run.fish
 \f[R]
 .fi
 .PP
@@ -1825,7 +1831,7 @@ Examples:
 # Disable command shadows only (rm becomes plain rm again):
 set -U __fish_config_op_aliases off
 
-# Full minimal mode \[em] disable all five categories at once:
+# Full minimal mode \[em] disable all six categories at once:
 set -U __fish_config_opinionated 0
 
 # Re-enable everything:
@@ -1896,7 +1902,8 @@ fish_config theme save \[dq]Catppuccin Latte\[dq]
 Fisher is bootstrapped automatically on the \f[B]first interactive
 session\f[R] via \f[V]conf.d/first_run.fish\f[R].
 This also applies the Catppuccin Mocha theme and prints a one-time
-welcome message.
+welcome message (gated by __fish_config_op_greeting; set it to 0 to
+suppress).
 Subsequent sessions skip all first-run logic with zero overhead.
 .PP
 To re-trigger first-run initialization (e.g., after a fresh install or
diff --git a/docs/html/11-7-customization.html b/docs/html/11-7-customization.html
index 5dfe145..8558c4f 100644
--- a/docs/html/11-7-customization.html
+++ b/docs/html/11-7-customization.html
@@ -519,7 +519,7 @@ commit fish_variables.</p>
 id="opinionated-components-minimal-mode">Opinionated Components (Minimal
 Mode)</h2>
 <p>Every opinionated piece of this config is active by default but can
-be switched off through five category opt-out variables, each evaluated
+be switched off through six category opt-out variables, each evaluated
 via __fish_variable_check. Set a variable to any falsy value (0, false,
 no, off, n) to disable its category; erase it or set a truthy value (1,
 true, yes, on, y) to re-enable. Unset means enabled.</p>
@@ -550,12 +550,18 @@ __fish_config_op_logging        Logging &amp; capture: scrollback
                                 capture on exit, paru/yay AUR log
                                 wrappers, Kitty watcher capture;
                                 sentinel file coordinates
-                                cross-process state</code></pre>
+                                cross-process state
+__fish_config_op_greeting       Greeting &amp; first-run UI: per-session
+                                fish_greeting override (defines empty
+                                function late in config.fish to
+                                suppress distro greetings such as
+                                CachyOS fastfetch); first-run welcome
+                                banner in conf.d/first_run.fish</code></pre>
 <p>Examples:</p>
 <pre><code># Disable command shadows only (rm becomes plain rm again):
 set -U __fish_config_op_aliases off
 
-# Full minimal mode — disable all five categories at once:
+# Full minimal mode — disable all six categories at once:
 set -U __fish_config_opinionated 0
 
 # Re-enable everything:
diff --git a/docs/html/12-8-fisher-plugins.html b/docs/html/12-8-fisher-plugins.html
index 155b540..485dc61 100644
--- a/docs/html/12-8-fisher-plugins.html
+++ b/docs/html/12-8-fisher-plugins.html
@@ -491,9 +491,9 @@
 <h1 data-number="12" id="8-fisher-plugins">8. FISHER PLUGINS</h1>
 <p>Fisher is bootstrapped automatically on the <strong>first interactive
 session</strong> via <code>conf.d/first_run.fish</code>. This also
-applies the Catppuccin Mocha theme and prints a one-time welcome
-message. Subsequent sessions skip all first-run logic with zero
-overhead.</p>
+applies the Catppuccin Mocha theme and prints a one-time welcome message
+(gated by __fish_config_op_greeting; set it to 0 to suppress).
+Subsequent sessions skip all first-run logic with zero overhead.</p>
 <p>To re-trigger first-run initialization (e.g., after a fresh install
 or for testing), run:</p>
 <pre><code>set -Ue __fish_config_first_run_complete</code></pre>
diff --git a/docs/wiki/7-customization.md b/docs/wiki/7-customization.md
index 708c9ca..50b5519 100644
--- a/docs/wiki/7-customization.md
+++ b/docs/wiki/7-customization.md
@@ -40,7 +40,7 @@ fish_variables.
 ## Opinionated Components (Minimal Mode)
 
 Every opinionated piece of this config is active by default but can be
-switched off through five category opt-out variables, each evaluated via
+switched off through six category opt-out variables, each evaluated via
 __fish_variable_check. Set a variable to any falsy value (0, false, no,
 off, n) to disable its category; erase it or set a truthy value (1, true,
 yes, on, y) to re-enable. Unset means enabled.
@@ -73,13 +73,19 @@ yes, on, y) to re-enable. Unset means enabled.
                                     wrappers, Kitty watcher capture;
                                     sentinel file coordinates
                                     cross-process state
+    __fish_config_op_greeting       Greeting & first-run UI: per-session
+                                    fish_greeting override (defines empty
+                                    function late in config.fish to
+                                    suppress distro greetings such as
+                                    CachyOS fastfetch); first-run welcome
+                                    banner in conf.d/first_run.fish
 
 Examples:
 
     # Disable command shadows only (rm becomes plain rm again):
     set -U __fish_config_op_aliases off
 
-    # Full minimal mode — disable all five categories at once:
+    # Full minimal mode — disable all six categories at once:
     set -U __fish_config_opinionated 0
 
     # Re-enable everything:
diff --git a/docs/wiki/8-fisher-plugins.md b/docs/wiki/8-fisher-plugins.md
index c6a885f..ec1a6ea 100644
--- a/docs/wiki/8-fisher-plugins.md
+++ b/docs/wiki/8-fisher-plugins.md
@@ -6,8 +6,9 @@
 
 Fisher is bootstrapped automatically on the **first interactive session** via
 `conf.d/first_run.fish`. This also applies the Catppuccin Mocha theme and
-prints a one-time welcome message. Subsequent sessions skip all first-run
-logic with zero overhead.
+prints a one-time welcome message (gated by __fish_config_op_greeting; set
+it to 0 to suppress). Subsequent sessions skip all first-run logic with zero
+overhead.
 
 To re-trigger first-run initialization (e.g., after a fresh install or for
 testing), run: