Skip to content

Add Cursor Cloud specific instructions to AGENTS.md#3808

Closed
yasserfaraazkhan wants to merge 4 commits into
masterfrom
cursor/env-setup-bf28
Closed

Add Cursor Cloud specific instructions to AGENTS.md#3808
yasserfaraazkhan wants to merge 4 commits into
masterfrom
cursor/env-setup-bf28

Conversation

@yasserfaraazkhan
Copy link
Copy Markdown
Contributor

@yasserfaraazkhan yasserfaraazkhan commented May 1, 2026

Summary

  • Add Cloud Agent environment setup instructions to AGENTS.md (app launch, E2E testing, gotchas)
  • Fix E2E Playwright tests for headless/container CI environments:
    • Remove --no-zygote flag that prevented renderer processes from spawning
    • Add --in-process-gpu and --enable-features=NetworkServiceInProcess2 to avoid network service subprocess crashes
    • Fix waitForAppReady to force-show the main window in headless/VNC environments

Before: Only welcome-screen tests (no servers) passed in Cloud Agent VMs
After: 28+ tests pass including config, settings, menu bar, and downloads suites

Ticket Link

N/A - Environment documentation and CI compatibility improvement

Checklist

  • Added or updated unit tests (required for all new features)
  • read and understood our Contributing Guidelines
  • executed npm run lint:js for proper code formatting

Device Information

This PR was tested on: Cursor Cloud Agent VM (Ubuntu 24.04, x86_64, TigerVNC on :1)

Screenshots

Mattermost Desktop app running in Cloud Agent VM

Release Note

NONE
Open in Web Open in Cursor 

Document how to run the Electron app in the Cloud Agent VM environment,
including the required flags to work around network service subprocess
crashes in containerized environments. Add quick reference for key
development commands and gotchas.

Co-authored-by: yasser khan <attitude3cena.yf@gmail.com>
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 1, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: a3bf3762-84f5-47bb-97c3-6fd74a7ae833

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch cursor/env-setup-bf28

Comment @coderabbitai help to get the list of available commands and usage tips.

cursoragent and others added 3 commits May 1, 2026 11:00
Document setup steps, running commands, environment variables, and
known container-environment limitations for the Playwright E2E test
suite in Cloud Agent VMs.

Co-authored-by: yasser khan <attitude3cena.yf@gmail.com>
- Remove --no-zygote flag: was preventing renderer child processes from
  spawning, causing all window URLs to be empty. The zygote process is
  essential for Chromium's process model.
- Add --in-process-gpu and --enable-features=NetworkServiceInProcess2:
  prevents network service subprocess crashes in Firecracker/Docker.
- Fix waitForAppReady to force-show the main window in headless/VNC
  environments where BrowserWindow.show() doesn't fire automatically.

Before: only tests using emptyConfig (welcome screen) passed.
After: 28+ tests pass including config, settings, menu bar, downloads.

Co-authored-by: yasser khan <attitude3cena.yf@gmail.com>
Co-authored-by: yasser khan <attitude3cena.yf@gmail.com>
@yasserfaraazkhan yasserfaraazkhan deleted the cursor/env-setup-bf28 branch May 2, 2026 00:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants