Skip to content

Add Cursor Cloud specific development environment instructions#10

Draft
Rushik-B wants to merge 2 commits intomainfrom
cursor/development-environment-setup-3e98
Draft

Add Cursor Cloud specific development environment instructions#10
Rushik-B wants to merge 2 commits intomainfrom
cursor/development-environment-setup-3e98

Conversation

@Rushik-B
Copy link
Copy Markdown
Owner

@Rushik-B Rushik-B commented Mar 16, 2026

Summary

Adds a ## Cursor Cloud specific instructions section to AGENTS.md with operational notes discovered during development environment setup. These instructions help future cloud agents bootstrap and run the Clira development environment correctly.

What changed

  • Added documentation for Docker infrastructure setup (PostgreSQL 16 + pgvector on port 15432, Redis 7 on port 16379)
  • Documented the fresh-volume gotcha for the DB init script and pgvector extension requirement
  • Documented app/worker startup commands and the /api/health auth behavior
  • Noted the pre-existing test failure in executive-agent-selector.test.ts
  • Documented minimal .env configuration requirements for local development
  • Documented Google 2FA blocker for automated login and Desktop pane workaround
  • Documented onboarding flow steps and Gmail/Gemini API dependencies

Verification

  • npm run lint passes cleanly (0 warnings/errors)
  • npm test passes 193/194 tests (1 pre-existing failure in executive-agent-selector.test.ts)
  • npm run build:worker compiles successfully
  • npm run dev starts the Next.js dev server on port 3000
  • Full Google OAuth login completed successfully (via Desktop pane for 2FA)
  • Onboarding flow completed: inbox analysis, label generation, dashboard loaded
  • Settings pages (Account, Assistant & Replies) verified working with connected Gmail account
Open in Web Open in Cursor 

cursoragent and others added 2 commits March 16, 2026 20:33
- Document Docker infrastructure setup (Postgres pgvector on 15432, Redis on 16379)
- Document fresh volume gotcha for DB init scripts and pgvector extension
- Document app/worker startup commands and health endpoint auth behavior
- Note pre-existing test failure in executive-agent-selector
- Document minimal .env configuration requirements

Co-authored-by: Rushik-B <Rushik-B@users.noreply.github.com>
- Document Google 2FA blocker for automated login
- Document onboarding flow steps and Gmail/Gemini API dependencies
- Note post-onboarding Queue page behavior

Co-authored-by: Rushik-B <Rushik-B@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