docs: add Cursor Cloud environment setup notes - #669
Draft
rrama wants to merge 2 commits into
Draft
Conversation
Co-authored-by: Ben Durrans <Benjamin.Durrans@snyk.io>
✅ Snyk checks have passed. No issues have been found so far.
💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse. |
✅ Snyk checks have passed. No issues have been found so far.
💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse. |
Consolidates the duplicate cloud-setup notes into a single AGENTS.md, keeping the parallel branch's more precise diagnosis of the networking test: the live GET to www.snyk.io 301-redirects to the bare snyk.io apex, which is why it fails only when that apex is missing from the allowlist. Describes that test as network-gated rather than a product defect, and points at PR #673, which replaces the live call with an httptest server and makes the caveat moot. Replaces the fixed reachable/blocked host list with guidance to probe egress directly, since the allowlist changes between runs. Co-authored-by: Cursor <cursoragent@cursor.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Adds a
## Cursor Cloud specific instructionssection toAGENTS.md(and thereforeCLAUDE.md, which is a symlink to it), capturing the non-obvious setup gotchas anagent hits when building GAF in a Cursor Cloud Linux VM. Documentation only — no
product code, and no change to any exported API, config key, workflow identifier or
content type.
Two duplicate cloud-setup PRs had been opened against this repo by successive cloud
runs. This one now carries the consolidated content and #670 has been closed as
superseded, leaving a single PR per repo.
The notes cover:
GOTOOLCHAIN=go1.26.5must stay pinned.go.moddeclares a barego 1.26, sowith
GOTOOLCHAIN=autoGo tries to fetch a non-existentgo1.26toolchain fromgo.devand fails; the pin routes it throughproxy.golang.org.make toolscurlsgolangci-lint.run(Makefile:50), which is usually outsidethe allowlist. Install the pinned
v2.10.1from the module proxy into.bin/instead. GAF is the odd one out here — snyk-ls and code-client-go fetch the same tool
via
raw.githubusercontent.com.pkg/networking.Test_GetHTTPClientis network-gated, not broken. It does a liveGET https://www.snyk.io, which 301-redirects to the baresnyk.ioapex; it passeswhenever that apex is reachable and only fails (nil-dereferencing on the unchecked
error path) when the egress is missing.
What changed since the first revision
and kept the other branch's more precise diagnosis — the
www→ apex redirect iswhat makes it fail, which is easy to misread as
www.snyk.iobeing blocked. It nowalso points at test(networking): remove live snyk.io call from Test_GetHTTPClient #673, which replaces the live call with an
httptestserver and makesthe caveat moot once merged.
between runs, so a fixed map goes stale and gets trusted anyway. Readers are told to
probe directly, with the semantics that explain the failure above: bare entries are
apex-exact while
*.example.comcovers subdomains only, so*.snyk.iodoes notimply the
snyk.ioapex.Checklist
make test) — n/a, no code changes; markdown onlymake generate) — n/a, nothing generated is affectedmake lint) — n/a, no Go files touchedto consume and no
go.mod/go.sumchange, so no companion CLI PR is needed