docs(repo): add cursor cloud dev environment instructions

[mikepitre]

Description

Adds a ## Cursor Cloud specific instructions section to AGENTS.md documenting the durable, non-obvious details of the Cloud Agent development environment so future agents can start fast and avoid known footguns:

• Node/pnpm resolution: Node 24.15.0 (required by engines) is installed via nvm and made to win over the daemon's bundled /exec-daemon/node (v22) via symlinks in /usr/local/cargo/bin (which precedes /exec-daemon in PATH). Because the Cursor shell is non-interactive and doesn't source ~/.bashrc, this symlink layer — not a profile edit — is what makes bare node/pnpm/npx resolve to v24 in every shell.
• Runnable app: pnpm dev:sandbox serves the clerk-js UI sandbox at http://localhost:4000 (+ @clerk/ui on :4011), secret-free thanks to a staging publishable key baked into the sandbox template.
• Known caveat: root pnpm lint exits non-zero on a clean checkout for reasons unrelated to environment setup (scripts/lint.mjs appends --quiet, which tsc 6.0.3 rejects for packages whose lint chains typecheck; plus pre-existing eslint errors under scripts/ and integration/). Package-scoped pnpm turbo lint --filter=<pkg> is clean.
• Integration tests require 1Password-sourced secrets and live Clerk instances; unit tests run fully offline.

Dependency install for the environment is handled by the startup update script (pnpm install --frozen-lockfile); no code behavior changes.

Checklist

• pnpm test runs as expected.
• pnpm build runs as expected.
• (If applicable) JSDoc comments have been added or updated for any package exports
• (If applicable) Documentation has been updated

Type of change

• 🐛 Bug fix
• 🌟 New feature
• 🔨 Breaking change
• 📖 Refactoring / dependency upgrade / documentation

  

[changeset-bot]

🦋 Changeset detected

Latest commit: 8f9aae3

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
clerk-js-sandbox	Ready	Preview	Aug 24, 2026 9:52pm
swingset	Ready	Preview	Aug 24, 2026 9:52pm

[pkg-pr-new]

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9539

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9539

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9539

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9539

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9539

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9539

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9539

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9539

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9539

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9539

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9539

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9539

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9539

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9539

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9539

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9539

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9539

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9539

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9539

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9539

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9539

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9539

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9539

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9539

commit: 8f9aae3