guide: add a 'getting the code' note — the Cloudflare/User-Agent clone gotcha (for humans and agents), with the browser-UA + SSH workarounds

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-24 23:36:07 -04:00
parent 559caead36
commit ea835b8837
1 changed files with 7 additions and 0 deletions
@@ -16,6 +16,13 @@ frequencies, and you just have to be set up to hear them.*
 >   `docker/` (the container definitions), `config/` (templates). Every script has a header
 >   comment explaining what it does and how it's operated. The design rules that keep it robust
 >   are in §11. Start by reading this file, then `dashboard/serve.py` and `scripts/iq_hop.py`.
+>
+> **Getting the code:** `git clone <this-repo-url> istrain`. One gotcha worth knowing if this repo
+> is hosted behind Cloudflare (or a similar bot-shield): a plain browser and normal `git`/`curl`
+> clone fine, but a *headless* HTTP fetch (some scripts, some agent tool-calls) can get a 403 bot
+> wall. The fix is a normal browser User-Agent on the request, e.g.
+> `git -c http.userAgent="Mozilla/5.0" clone <url>` — or just use SSH, which sidesteps it entirely.
+> (This is a hosting quirk, not a code quirk; a fork on a plain host won't see it.)

 ---