Skip to content

Add Cursor Cloud specific instructions to AGENTS.md#25

Draft
ramonverse wants to merge 1 commit intomainfrom
cursor/dev-environment-setup-8824
Draft

Add Cursor Cloud specific instructions to AGENTS.md#25
ramonverse wants to merge 1 commit intomainfrom
cursor/dev-environment-setup-8824

Conversation

@ramonverse
Copy link
Copy Markdown
Contributor

Summary

Adds Cloud Agent-specific development environment instructions to AGENTS.md so future agents can efficiently set up and operate in this codebase.

What's added

  • Service startup order: Docker daemon -> PostgreSQL -> DB migrate/seed -> Dev server
  • Docker-in-Docker gotchas: fuse-overlayfs storage driver and iptables-legacy requirements for Firecracker VM
  • Environment config: Default .env.local setup, Turnstile test keys, optional AI provider keys
  • Key commands table: Quick reference for install, lint, build, dev, DB operations
  • Gotchas: Bun PATH, non-standard Postgres port (5437), no automated test suite

Demo

openlingo_dev_environment_demo.mp4
Full dev environment setup: sign-up, onboarding, and browsing units.

Landing page
Main dashboard with AI Tutor
Browse public units and courses

Verification

  • bun install - dependencies install successfully
  • bun run lint - ESLint runs (pre-existing warnings)
  • bun run build - production build succeeds
  • bun run dev - dev server starts on port 3000
  • Sign-up, onboarding, and unit browsing all work end-to-end

To show artifacts inline, enable in settings.

Open in Web Open in Cursor 

- Document Docker-in-Docker setup (fuse-overlayfs, iptables-legacy)
- Document service startup order and key commands
- Note environment configuration defaults and Turnstile test keys
- Document gotchas for Cloud Agent VM environment

Co-authored-by: Ramon Garate <ramonverse@users.noreply.github.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