Document Cursor Cloud dev environment setup in AGENTS.md#45
Draft
Sancus wants to merge 1 commit into
Draft
Conversation
Add a Cursor Cloud specific instructions section covering Node 24 via nvm, the required VITE_* proxy env vars, the docker-in-docker mail stack bring-up sequence, and the self-signed-cert SharedWorker gotcha. Co-authored-by: H <Sancus@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed?
Adds a
## Cursor Cloud specific instructionssection toAGENTS.mdcapturing how to set up and run the Stormbox dev environment on a Cursor Cloud VM (as opposed to the humanthundermail-devdevcontainer flow). It documents:npm/node/npx/Playwright directly on the VM, with only thethunderbird-accountsstack (Keycloak + Stalwart) in docker-in-docker.PATHshadowing gotcha (/exec-daemon/nodeis v22) and how to prepend the nvm v24 bin dir.VITE_*env vars that must be exported in the shell beforenpm run dev(Vite readsprocess.envdirectly invite.config.js, not.env.development).172.17.0.1stack host resolution (/.dockerenv), Docker 29 daemon caveats (fuse-overlayfs+ disabledcontainerd-snapshotter+iptables-legacy), the self-signed-cert SharedWorker fetch gotcha, and the Stalwart OIDC introspection negative-cache.admin@example.org/admin).This change is documentation only. It was agent-written and verified by an AI agent during a full environment setup.
Why?
Future Cursor Cloud agents start from a snapshot with the startup update script already run. These notes let them start services and run the app/tests without rediscovering the non-obvious Cloud-specific caveats.
Limitations and Notes
nvm install 24,npm ci, Playwright browsers) is configured separately via the Cloud environment setup, not in this PR.Applicable Issues
N/A — development environment documentation.
Screenshots
Hello-world verification: logged in as
admin@example.orgvia Keycloak OIDC and viewed the seeded inbox with a message body rendered.stormbox_login_inbox_demo.mp4
Stormbox inbox with a message open
To show artifacts inline, enable in settings.