From 90a813c9d3979eaccd1919cfb5f0cddb009a6fdc Mon Sep 17 00:00:00 2001
From: rootiest <chris@rootiest.com>
Date: Fri, 5 Jun 2026 19:48:14 -0400
Subject: [PATCH] refactor(config): annotate PATH entries and fix cargo append
 flag

Adds inline comments to all fish_add_path entries for self-documentation.
Removes the unused $HOME/Applications path. Changes cargo bin flag from
-mg to -mga so the cargo bin directory is appended to PATH rather than
prepended, avoiding conflicts with system-installed Rust tools.
---
 config.fish | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/config.fish b/config.fish
index dafaf17..34bfff9 100644
--- a/config.fish
+++ b/config.fish
@@ -92,15 +92,16 @@ end
 #   Adds common user bin directories to the PATH. The -mg --move option for cargo ensures that
 #   the cargo bin directory is moved to the end of the PATH, which can help avoid conflicts
 #   with system-installed Rust tools while still allowing user-installed cargo binaries to be found.
-fish_add_path $HOME/.local/bin
-fish_add_path $HOME/Applications
-fish_add_path $HOME/scripts
-fish_add_path -mg --move $CARGO_HOME/bin
-fish_add_path $BUN_INSTALL/bin
-fish_add_path $XDG_DATA_HOME/npm-global/bin
-fish_add_path $HOME/.lmstudio/bin
-fish_add_path $HOME/.resend/bin
-fish_add_path $HOME/.fzf/bin
+fish_add_path $HOME/.local/bin               # Standard user-local executables (XDG spec)
+fish_add_path $HOME/.local/share/../bin      # Alternative/legacy path for local user binaries
+fish_add_path $HOME/Applications             # User-installed applications and standalone apps
+fish_add_path $HOME/scripts                  # Custom personal shell scripts and automation
+fish_add_path -mga $CARGO_HOME/bin           # Rust binaries and tools installed via Cargo
+fish_add_path $BUN_INSTALL/bin               # Bun runtime executables and globally installed packages
+fish_add_path $XDG_DATA_HOME/npm-global/bin  # Global Node.js/npm packages (XDG compliant location)
+fish_add_path $HOME/.lmstudio/bin            # LM Studio CLI tools for local LLM management
+fish_add_path $HOME/.resend/bin              # Resend email service CLI tools
+fish_add_path $HOME/.fzf/bin                 # Fuzzy Finder (fzf) core binary and helper scripts
 
 #   ───────────────────────── CDPATH projects dir ──────────────────────────
 # Allows cd-ing to directories within $HOME/projects or $HOME without needing to specify the full path.