Skip to content

docs: add AGENTS.md with Cursor Cloud dev environment notes#307

Draft
jqdsouza wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-a6bd
Draft

docs: add AGENTS.md with Cursor Cloud dev environment notes#307
jqdsouza wants to merge 1 commit into
mainfrom
cursor/setup-dev-environment-a6bd

Conversation

@jqdsouza

Copy link
Copy Markdown
Contributor

Summary

Sets up and verifies the development environment for this repo in Cursor Cloud, and records durable, non-obvious setup notes for future cloud agents in a new AGENTS.md.

No product/source code was changed — this PR only adds AGENTS.md. The reusable dependency-refresh steps are captured in the Cloud environment update script (installs Go 1.25, warms Go module + npm caches), not in the repo.

What was verified

  • Go toolchain: base image ships Go 1.22 which is too old; installed Go 1.25.5 (satisfies go 1.24 modules and the go 1.25.0 collector exporter module). go.dev is egress-blocked, so GOTOOLCHAIN=auto fails — set GOTOOLCHAIN=local and fetch the toolchain from dl.google.com.
  • Build: cd cli/beacon && make build (builds + embeds beacon-hooks).
  • Go tests: go test ./... across all four modules + go test -race ./internal/endpoint/.... All pass except two macOS-only tests that CI runs on macos-latest (TestConfigureVSCodePreservesSettingsAndDisablesContentCaptureByDefault, TestRollbackReportsCollectorRestartFailure).
  • Lint: golangci-lint run executes (not a CI gate; reports pre-existing findings).
  • TypeScript SDK: npm ci, npm test (22 passing), npm run check, npm run build, npm run pack:dry-run.
  • End-to-end product run: captured telemetry via the hooks binary (as Cursor does), detected a curl-pipe-to-shell threat with beacon scan, and viewed the events + findings in the local beacon endpoint dashboard.

beacon_dashboard_walkthrough.mp4

Findings page showing curl-pipe-to-shell HIGH finding

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

Co-authored-by: Justin D'Souza <jqdsouza@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants