diff --git a/.github/workflows/example.yml b/.github/workflows/example.yml
index 9c53272..a0bb31c 100644
--- a/.github/workflows/example.yml
+++ b/.github/workflows/example.yml
@@ -78,6 +78,11 @@ jobs:
           name: dist
           path: dist # overwrite dist/index.js
 
+      # https://github.com/freckle/stack-action/issues/489
+      - if: ${{ startsWith(matrix.runner, 'macOS-') }}
+        run: |
+          sudo xcode-select -s /Library/Developer/CommandLineTools
+
       - id: stack
         uses: ./
         with:
diff --git a/README.md b/README.md
index 5b6986c..884f808 100644
--- a/README.md
+++ b/README.md
@@ -180,6 +180,23 @@ jobs:
 See [generate-matrix/action.yml](./generate-matrix/action.yml) for more details.
 This has been available since version 4 of this action.
 
+## MacOS Linker Errors
+
+On certain `macOS` runners, you may encounter:
+
+```
+ld: multiple errors: tapi error: malformed file
+```
+
+To fix, add the following:
+
+```yaml
+- run: |
+    sudo xcode-select -s /Library/Developer/CommandLineTools
+```
+
+See https://github.com/freckle/stack-action/issues/489 for more details.
+
 ## Development
 
 - **Package manager**: pnpm (Node version pinned in `.nvmrc`)