Skip to content

Added Cursor Cloud specific instructions to AGENTS.md#27194

Closed
jonatansberg wants to merge 1 commit intomainfrom
cursor/development-environment-setup-ea5e
Closed

Added Cursor Cloud specific instructions to AGENTS.md#27194
jonatansberg wants to merge 1 commit intomainfrom
cursor/development-environment-setup-ea5e

Conversation

@jonatansberg
Copy link
Copy Markdown
Member

What does this PR do?

Adds a ## Cursor Cloud specific instructions section to AGENTS.md with non-obvious development environment caveats discovered during Cloud Agent setup:

  • Docker requirement: Documents that yarn dev requires Docker and that pre-building images prevents timeout issues
  • Admin Vite race condition: The @tryghost/admin Vite dev server can fail on cold starts because it probes the Ghost backend before it's ready
  • Key ports table: Quick reference for all dev server ports
  • Testing notes: Clarifies which tests need Docker and which don't

Why?

Future Cursor Cloud agents need to know about these gotchas to set up the development environment reliably without trial-and-error.

Evidence of working environment

ghost-dev-environment-demo.mp4

Ghost frontend, admin panel, and post creation all working end-to-end.

Ghost homepage showing published post
Admin posts list

  • I've read and followed the Contributor Guide
  • I've explained my change
  • N/A for automated tests (documentation-only change)

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

Context: Captured non-obvious dev environment caveats (Docker requirement,
admin Vite race condition, key ports) for future cloud agents.
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 7, 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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 3c53a219-9d37-4b8f-a5bd-a07a333da25b

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/development-environment-setup-ea5e

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud bot commented Apr 7, 2026

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