From bc8339895a38b48dfb6280ed3d09c76b8648e2a4 Mon Sep 17 00:00:00 2001 From: rootiest Date: Sat, 6 Jun 2026 23:00:53 -0400 Subject: [PATCH] docs: document first-run initialization in fish-config.md --- docs/fish-config.md | 13 ++++++++++++- 1 file changed, 12 insertions(+), 1 deletion(-) diff --git a/docs/fish-config.md b/docs/fish-config.md index b93c14c..1170a03 100644 --- a/docs/fish-config.md +++ b/docs/fish-config.md @@ -1196,7 +1196,18 @@ fish_variables. # 8. FISHER PLUGINS -Fisher is bootstrapped automatically on first shell start if not present. +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. + +To re-trigger first-run initialization (e.g., after a fresh install or for +testing), run: + + set -Ue __fish_config_first_run_complete + +Then open a new shell. + The plugin list is maintained in fish_plugins at the config root. jorgebucaran/fisher Plugin manager itself