Skip to content

Add Cursor Cloud Agent environment config - #9

Open
RayFernando1337 wants to merge 1 commit into
mainfrom
cursor/cloud-agent-env-setup-7f4b
Open

Add Cursor Cloud Agent environment config#9
RayFernando1337 wants to merge 1 commit into
mainfrom
cursor/cloud-agent-env-setup-7f4b

Conversation

@RayFernando1337

@RayFernando1337 RayFernando1337 commented Aug 13, 2026

Copy link
Copy Markdown
Owner

What

Adds .cursor/environment.json so Cloud Agents get a fully working, versioned dev environment for this repo. It wires up the existing, purpose-built cloud-agent scripts already on main:

  • install: ./scripts/cloud-agent-install.sh — puts Bun on PATH, runs bun install --frozen-lockfile, and (only when CLERK_JWT_ISSUER_DOMAIN is set) provisions a local Convex backend and pushes functions.
  • terminals.dev: ./scripts/cloud-agent-start.sh — runs bunx convex dev --start 'bun dev' when CLERK_JWT_ISSUER_DOMAIN is set, otherwise bun dev alone so public pages still come up with zero secrets.
  • ports: 3000 (Next.js) and 3210 (Convex local backend).

The dev server is a long-running foreground process, so it lives in terminals (visible logs, restartable) rather than install/start, per the environment lifecycle guidance.

Why

There was no committed .cursor/environment.json, so Cloud Agents had no defined setup. A committed file is the highest-precedence environment source and makes setup follow the repo/branches, matching the Bun-based workflow already documented in AGENTS.md. Once merged to main, future Cloud Agents pick it up automatically.

Validation

Validated on the current VM, then re-validated on a fresh Cloud Agent booted from a tested draft build (bld-20260813-cb57fc07-4b9f-42bb-9d6b-8389af61fea0, SUCCEEDED):

Check Result
./scripts/cloud-agent-install.sh Exit 0; Bun 1.3.14, 377 packages; Convex skipped with no secrets
Install idempotence Passed twice ("no changes")
bun run lint Pass
bun run typecheck Pass
bun run build Pass (7 routes compiled)
Dev servers (cloud-agent-start.sh) Convex local backend :3210 + Next.js :3000 up
/, /board, /harness HTTP 200
/board live query Renders submissions.board empty-state from local Convex
/harness host triage 4 status changes update cards live
Fresh Cloud Agent (tested build) Build id matches; deps + committed codegen present; all checks pass; routes 200

No secrets are committed; .env.local and .convex/ remain gitignored. The local Convex backend and a placeholder Clerk publishable key used to drive the UI locally were kept only in the gitignored .env.local.

Open in Web Open in Cursor 

Co-authored-by: Ray Fernando <RayFernando1337@users.noreply.github.com>
@vercel

vercel Bot commented Aug 13, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
aios-lightning Ready Ready Preview Aug 13, 2026 5:51am

Request Review

@RayFernando1337
RayFernando1337 marked this pull request as ready for review August 13, 2026 06:02

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Devin Review: No Issues Found

Devin Review analyzed this PR and found no potential bugs to report.

View in Devin Review to see 1 additional finding.

Open in Devin Review

@cursor cursor Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Risk: low. Approved. Cursor Bugbot passed with no findings requiring human review on this single Cloud Agent environment config file, and no reviewers were assigned.

Open in Web View Automation 

Sent by Cursor Approval Agent: Pull Request Router and Approver

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