diff --git a/config.fish b/config.fish
index dd1a860..8234511 100644
--- a/config.fish
+++ b/config.fish
@@ -108,7 +108,7 @@ if type -q nvim
 else
     set -gx EDITOR (command -s vi)
 end
-set -gx VISUAL $EDITOR
+# set -gx VISUAL $EDITOR # <- Use local.fish to set your preferred GUI editor.
 set -gx SUDO_EDITOR $EDITOR
 
 #   ──────────────────────────── GPG variables ─────────────────────────────
diff --git a/docs/fish-config.md b/docs/fish-config.md
index 215feb3..033f501 100644
--- a/docs/fish-config.md
+++ b/docs/fish-config.md
@@ -159,7 +159,8 @@ Tools that respect XDG are directed to these paths rather than polluting $HOME.
 ## Editor and Pager
 
     EDITOR      nvim (falls back to vi if nvim is absent)
-    VISUAL      same as EDITOR
+    VISUAL      unset by default; set a GUI editor via local.fish (the edit
+                function falls back to a GUI chain when VISUAL is empty)
     SUDO_EDITOR same as EDITOR
     PAGER       ov (falls back to less)