diff --git a/.env.example b/.env.example
index 55577e3..0c77f45 100644
--- a/.env.example
+++ b/.env.example
@@ -1,5 +1,5 @@
 # Local secrets for Claude Code plugin install scripts.
-# Copy to .env and fill in real values. .env is gitignored.
+# Copy to ~/.claude/.env and fill in real values. link.sh symlinks repo/.env to it; the secret never enters git.
 #
 # Used by: lib/toggle-external.sh enable|disable magic
 # Get a key at: https://21st.dev/magic (dashboard → API keys)