diff --git a/.changeset/brave-hawks-fly.md b/.changeset/brave-hawks-fly.md
new file mode 100644
index 000000000..c87926d19
--- /dev/null
+++ b/.changeset/brave-hawks-fly.md
@@ -0,0 +1,5 @@
+---
+type: Fixed
+pr: 1487
+---
+**`/gsd-surface` works on Claude Code global installs** — the installer now writes a `.gsd-source` marker and install-exports resolve in the deployed layout, so `list`/`status` and `profile`/`enable`/`disable`/`reset` no longer throw `could not locate commands/gsd` or `MODULE_NOT_FOUND`.