diff --git a/etc/profile.d/omarchy.sh b/etc/profile.d/omarchy.sh
index 1aa7c29e..0af8bf13 100644
--- a/etc/profile.d/omarchy.sh
+++ b/etc/profile.d/omarchy.sh
@@ -5,9 +5,12 @@
 # points at a local checkout when active.
 export OMARCHY_PATH="${OMARCHY_PATH:-/usr/share/omarchy}"
 
-# Convenience: prepend Omarchy's user-installable bin to PATH if it exists.
-# (Mainly relevant for the script-install path; /usr/bin is already on PATH
-# for the package-install path.)
+# Prepend $OMARCHY_PATH/bin if it exists. In normal package mode this is a
+# no-op: bins ship to /usr/bin (already on PATH), and /usr/share/omarchy/bin
+# doesn't exist. The case that matters is omarchy-dev-link, which makes
+# /usr/share/omarchy a symlink to a local checkout; then this prepend lets
+# the checkout's bin/omarchy-* override the /usr/bin copies installed by
+# the package.
 case ":$PATH:" in
   *":$OMARCHY_PATH/bin:"*) ;;
   *) [ -d "$OMARCHY_PATH/bin" ] && export PATH="$OMARCHY_PATH/bin:$PATH" ;;