diff --git a/assets/README.md b/assets/README.md
index f22cb32..9040aee 100644
--- a/assets/README.md
+++ b/assets/README.md
@@ -100,4 +100,15 @@ assets/
 |----------|---------|-----------|
 | `ASSETS_BASE_URL` | Base URL for remote downloads | Only without a clone |
 | `AGENTS_DIR` | Custom agents install path | No || `SKILLS_DIR` | Custom skills install path | No || `INSTRUCTIONS_DIR` | Custom instructions install path | No |
-| `REPO_TOKEN` | Auth token for private repos | Only if API rejects |
\ No newline at end of file
+| `REPO_TOKEN` | Auth token for private repos | Only if API rejects |
+
+---
+
+## VS Code Agent Selector Integration
+To make your global agents available in the VS Code Agents selector, symlink your agent files from the global `~/.agents/agents/` directory to VS Code's prompts folder:
+
+```bash
+ln -s ~/.agents/agents/* "$HOME/Library/Application Support/Code/User/prompts/"
+```
+
+This ensures all your agents appear in the selector for easy access. The `$HOME` variable automatically uses your user directory, so the command works for any account.
\ No newline at end of file