Skip to content

docs: add Cursor Cloud dev environment setup instructions#2741

Draft
mitul-s wants to merge 2 commits into
mainfrom
c+ms/dev-environment-setup-9c51
Draft

docs: add Cursor Cloud dev environment setup instructions#2741
mitul-s wants to merge 2 commits into
mainfrom
c+ms/dev-environment-setup-9c51

Conversation

@mitul-s

@mitul-s mitul-s commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

Summary

Sets up and validates the Cloud Agent development environment for this repo and documents the non-obvious setup caveats discovered along the way. The only code change is an additive ## Cursor Cloud specific instructions section in AGENTS.md.

Environment setup

  • Update script (runs on VM startup): pnpm install — minimal and idempotent. Rust toolchain and package builds are intentionally left out of the update script (documented in AGENTS.md instead).
  • Rust caveat: @workflow/swc-plugin compiles a WASM binary needing Rust ≥ 1.87 (edition 2024) + wasm32-unknown-unknown. The VM default was 1.83, so it was updated via rustup default stable (1.96.1) + rustup target add wasm32-unknown-unknown. There is no committed prebuilt .wasm, so pnpm build is mandatory before running downstream apps/e2e.
  • Local dev uses the filesystem "world" — no database required.

Verification

  • pnpm install
  • pnpm build (27 packages, including the Rust→WASM SWC plugin)
  • pnpm typecheck (40 tasks)
  • ⚠️ pnpm lint (biome check) runs but reports pre-existing findings; not part of CI gating in .github/workflows/lint.yml
  • pnpm vitest run core unit tests (283 passed)
  • nextjs-turbopack dev server on port 3000; ran addTenWorkflow([123]) → 133 via HTTP and simple([42]) → 57 via the browser UI
  • ✅ e2e subset sleepingWorkflow against the local dev server

Demo of running the simple workflow end-to-end through the web UI (completes with result 57):

workflow_sdk_run_simple_workflow_demo.mp4

simple workflow completed with result 57

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

@vercel

vercel Bot commented Jul 1, 2026

Copy link
Copy Markdown
Contributor

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

Project Deployment Actions Updated (UTC)
example-nextjs-workflow-turbopack Ready Ready Preview, Comment Jul 1, 2026 5:14pm
example-nextjs-workflow-webpack Ready Ready Preview, Comment Jul 1, 2026 5:14pm
example-workflow Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workbench-astro-workflow Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workbench-express-workflow Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workbench-fastify-workflow Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workbench-hono-workflow Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workbench-nitro-workflow Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workbench-nuxt-workflow Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workbench-sveltekit-workflow Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workbench-tanstack-start-workflow Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workbench-vite-workflow Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workflow-swc-playground Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workflow-tarballs Ready Ready Preview, Comment Jul 1, 2026 5:14pm
workflow-web Ready Ready Preview, Comment Jul 1, 2026 5:14pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
workflow-docs Skipped Skipped Jul 1, 2026 5:14pm

@changeset-bot

changeset-bot Bot commented Jul 1, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 0613053

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

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

Click here to learn what changesets are, and how to add one.

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

I, Cursor Agent <cursoragent@cursor.com>, hereby add my Signed-off-by to this commit: 0613053

Signed-off-by: Cursor Agent <cursoragent@cursor.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