Skip to content

Add Cursor Cloud development environment setup instructions#4

Draft
ropoko wants to merge 3 commits into
mainfrom
cursor/development-environment-setup-c76c
Draft

Add Cursor Cloud development environment setup instructions#4
ropoko wants to merge 3 commits into
mainfrom
cursor/development-environment-setup-c76c

Conversation

@ropoko
Copy link
Copy Markdown
Collaborator

@ropoko ropoko commented Apr 1, 2026

Summary

Adds ## Cursor Cloud specific instructions section to AGENTS.md to enable future Cloud Agents to quickly set up the full development environment (game client + backend).

Changes

  • AGENTS.md: Added Cloud-specific section documenting:
    • Love2D v12 nightly installation path (/opt/love2d/) and LD_LIBRARY_PATH configuration
    • lua-https build-from-source instructions (cmake + g++ against libcurl/openssl)
    • Backend Docker Compose setup (Postgres, API, Nakama, SeaweedFS)
    • First-time SeaweedFS S3 credential creation and card seeding steps
    • Backend test commands
    • Docker-in-VM setup notes (fuse-overlayfs, iptables-legacy)
    • Expected ALSA audio errors in headless VM environments

Environment Verification

Both the game client and full backend stack were set up and verified end-to-end:

Game Client (Love2D):

  • Love2D v12 nightly installed and running
  • luacheck linting passes: 0 warnings / 0 errors across 50 files
  • lua-https native module built from source and working

Backend (Docker Compose):

  • All 7 services running: Postgres, API, Nakama, SeaweedFS (master, volume, filer, S3)
  • Migrations and Nakama FDW configured automatically
  • Django tests pass: 2/2
  • Default cards seeded (Caveman, Dino, Thunder)

End-to-End:

  • Game client connects to backend via /.well-known/nodeinfo validation
  • User signup and signin work through the API
  • Game transitions from server selection → auth → lobby → deck builder

Lobby screen after successful login with Welcome toast
Deck builder showing seeded card catalog (Caveman, Dino, Thunder)

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

cursoragent and others added 2 commits April 1, 2026 18:41
- Document Love2D v12 nightly installation path and LD_LIBRARY_PATH setup
- Document lua-https build-from-source steps for the Cloud VM
- Note ALSA audio errors are expected in headless environments
- Document backend service requirements (World API + Nakama)
- Reference existing linting and testing documentation

Co-authored-by: Rodrigo Stramantinoli <rodrigostramantinoli@gmail.com>
- Document Docker Compose workflow for backend services (Postgres, API, Nakama, SeaweedFS)
- Add first-time SeaweedFS S3 credential and card seeding instructions
- Document backend test command
- Add Docker-in-VM setup notes (fuse-overlayfs, iptables-legacy)

Co-authored-by: Rodrigo Stramantinoli <rodrigostramantinoli@gmail.com>
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Comment thread AGENTS.md Outdated
The ubuntu user is already in the docker group, which is the standard
and safer way to grant non-root Docker access.

Co-authored-by: Rodrigo Stramantinoli <rodrigostramantinoli@gmail.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