diff --git a/CLAUDE.md b/CLAUDE.md
index 38784552..a6279c01 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -2,6 +2,38 @@
 
 Working notes for Claude Code. Updated as work progresses.
 
+## ⚠️ Repository location, git & auth (relocated 2026-06-26)
+**The whole repo moved from `C:\VWE` → `C:\VWE\firestorm`** so `C:\VWE` can host other
+projects. `firestorm\` is now a **self-contained git repo** (its own `.git`); `C:\VWE` is just
+a parent container (NOT a git repo). All paths in this file and in build/deploy scripts are the
+new `C:\VWE\firestorm\...` paths.
+- **What the move touched:** physical move of all top-level entries (incl. `.git`); no junctions/
+  symlinks existed to break; single volume so it was an instant metadata rename. `git status` was
+  clean afterward (repo-relative paths unchanged) — the only diff was the path rewrites below.
+- **Hardcoded paths rewritten** `c:\VWE\... → c:\VWE\firestorm\...` (encoding-preserved) in:
+  `Gameleap\code\mw4\Libraries\stlport\stl_inc_find.hpp` (stlnative include — build-critical),
+  the `build-env\*.ps1` deploy/build scripts, `build-env\play-mr.*`, the `build-env\*.reg` files
+  (incl. UTF-16 `vc6-hklm-registration.reg`), and the docs (`CLAUDE.md`/`README.md`/`RECOVERY.md`).
+  Stale `build-env\*.log`/`.plg`/`.map` build artifacts still contain old paths (historical, unused).
+- **System registry was repointed to the new paths** (so build + run still work):
+  - HKCU: VC6 IDE directories (`...DevStudio\6.0\...\Directories`) + AppCompat `Layers` shims for
+    `MW4.exe`, `MW4pro.exe`, `MW4Ed2.exe`; dropped two stale `C:\VWE\MW4Editor\*` entries
+    (that dir was removed in STEP 9).
+  - HKLM (elevated): VC6 install registration (`Wow6432Node\...\VisualStudio\6.0`, ProductDir) +
+    all-users AppCompat shims for `MW4.exe`/`MW4pro.exe`.
+  - **Reminder:** AppCompat (`DWM8And16BitMitigation`) is keyed on the exe **PATH** — relocating an
+    exe requires re-applying the shim (the `.reg` files + `deploy-*.ps1` now use firestorm paths).
+- **Git remote (new):** `origin = https://gitea.mysticmachines.com/VWE/firestorm.git`
+  (was `http://192.168.1.167:3000/cyd/firestorm.git`; host + owner `cyd→VWE` changed; same backend,
+  so LFS objects already present — pushes only send new deltas). LFS access hint set to `basic`.
+- **Auth = Personal Access Token over basic auth**, stored in Windows Credential Manager. The Git
+  Credential Manager **browser-OAuth flow for Gitea FAILS here** (loopback redirect to
+  `127.0.0.1:<port>` does not complete). To (re)seed creds, run in Git Bash:
+  `printf 'protocol=https\nhost=gitea.mysticmachines.com\nusername=<USER>\npassword=<PAT>\n' | git credential approve`
+  (PAT needs `repository: Read and Write`). Then `git push` uses it with no browser prompt.
+- Uses **Git LFS**; `.gitattributes` forces `* -text` for byte-exact restores regardless of
+  `core.autocrlf`.
+
 ## What this project is
 A total-conversion / expansion ("FireStorm") built on the **MechWarrior 4** game
 engine (the *Gameleap* engine, v5.03), using Microsoft's **GameOS / GOS**