Skip to content

Set up Cursor Cloud dev environment (native backend + frontend + Postgres/Redis) - #18

Merged
venkateshsakamuri-lab merged 3 commits into
kaushik-IDEfrom
cursor/setup-dev-environment-231a
Aug 6, 2026
Merged

Set up Cursor Cloud dev environment (native backend + frontend + Postgres/Redis)#18
venkateshsakamuri-lab merged 3 commits into
kaushik-IDEfrom
cursor/setup-dev-environment-231a

Conversation

@venkateshsakamuri-lab

Copy link
Copy Markdown
Contributor

Summary

Sets up a full local development environment for DeepSQL (DBA Agent) in the Cursor Cloud VM and documents the non-obvious caveats for future agents. No application code was changed — only AGENTS.md gained a ## Cursor Cloud specific instructions section.

Environment

Runs the stack natively (no Docker):

  • Java 25 (Temurin) — required by backend/pom.xml (java.version=25); set as default java/javac and JAVA_HOME.
  • PostgreSQL 16 + pgvector + pg_stat_statements — vault DB dba_agent (port 5432), plus a demo target DB demo_shop with sample data.
  • Redis — cache on port 6379.
  • Backendbash scripts/start-backend.sh (./mvnw spring-boot:run), Jetty on :8080/api.
  • Frontendnpm run dev (Vite on :3000, proxies /api → 8080).

The startup update script is just npm install (system deps live in the VM snapshot). Durable startup/run caveats are captured in AGENTS.md.

Verified

Service Command Result
Backend bash scripts/start-backend.sh Started, /api/actuator/health = UP (db, redis, dbScheduler all UP)
Frontend npm run dev Vite serving on :3000 (HTTP 200)
Lint npm run lint Runs (pre-existing warnings/errors are the repo baseline)
Tests ./mvnw test -Dtest=ApiSmokeTest 3 tests, 0 failures

Hello-world

Registered a database connection to the local demo_shop DB through the web UI and browsed its schema, exercising the credential vault, ConnectionService, and schema introspection end to end.

Key caveats documented in AGENTS.md

  • .env is sourced under set -e — dotted property keys abort the script; use UPPERCASE Spring env names.
  • ENCRYPTION_KEYS (not just ENCRYPTION_KEY) must be set or the EncryptionService bean fails with a circular placeholder reference.
  • SECURITY_AUTH_ENABLED=false enables the dev auto-admin bypass.
  • scheduled_tasks table + extensions come from docker/postgres/init/*.sql (applied by hand in the native setup).
  • Stop the running backend before context-booting tests to avoid ddl-auto deadlocks.

Please merge the AGENTS.md updates so future agents remember these setup caveats next time.

Open in Web Open in Cursor 

cursoragent and others added 3 commits August 6, 2026 05:01
Co-authored-by: Venkat SF <venkatesh.sakamuri@stayflexi.com>
Capture the verified gpt-5.4 / embedding config shape and the Hermes
webui ALLOWED_ORIGINS requirement that otherwise 403s the Agent tab.

Co-authored-by: Venkat SF <venkatesh.sakamuri@stayflexi.com>
Co-authored-by: Venkat SF <venkatesh.sakamuri@stayflexi.com>
@venkateshsakamuri-lab
venkateshsakamuri-lab marked this pull request as ready for review August 6, 2026 07:42
@cursor

cursor Bot commented Aug 6, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

@venkateshsakamuri-lab
venkateshsakamuri-lab merged commit b204386 into kaushik-IDE Aug 6, 2026
6 checks passed
@venkateshsakamuri-lab
venkateshsakamuri-lab deleted the cursor/setup-dev-environment-231a branch August 6, 2026 07:43
venkateshsakamuri-lab added a commit that referenced this pull request Aug 6, 2026
#19)

<!-- CURSOR_AGENT_PR_BODY_BEGIN -->
## Summary

Adds the `## Cursor Cloud specific instructions` section to `AGENTS.md`
on **main**.

This is the same documentation that was previously merged via #18 into
`kaushik-IDE`. We are relocating it onto `main` so Cloud agents / local
setup docs live on the primary branch. A follow-up PR will revert #18
from `kaushik-IDE`.

## Changes

- `AGENTS.md` only — native (no Docker) Cloud VM service startup notes,
`.env` gotchas (`ENCRYPTION_KEYS`, dotted keys), Azure LLM config shape,
and Hermes `HERMES_WEBUI_ALLOWED_ORIGINS` requirement.

No application code changes.
<!-- CURSOR_AGENT_PR_BODY_END -->

<div><a
href="https://cursor.com/agents/bc-8ce91e70-c67b-48c6-84b3-05bb9d06231a?cursor_ref=pr_footer&cursor_cta=open_in_web"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://cursor.com/assets/images/open-in-web-dark.png"><source
media="(prefers-color-scheme: light)"
srcset="https://cursor.com/assets/images/open-in-web-light.png"><img
alt="Open in Web" width="114" height="28"
src="https://cursor.com/assets/images/open-in-web-dark.png"></picture></a>&nbsp;<a
href="https://cursor.com/background-agent?bcId=bc-8ce91e70-c67b-48c6-84b3-05bb9d06231a&cursor_ref=pr_footer&cursor_cta=open_in_cursor"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://cursor.com/assets/images/open-in-cursor-dark.png"><source
media="(prefers-color-scheme: light)"
srcset="https://cursor.com/assets/images/open-in-cursor-light.png"><img
alt="Open in Cursor" width="131" height="28"
src="https://cursor.com/assets/images/open-in-cursor-dark.png"></picture></a>&nbsp;</div>

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
venkateshsakamuri-lab added a commit that referenced this pull request Aug 6, 2026
<!-- CURSOR_AGENT_PR_BODY_BEGIN -->
## Summary

Reverts merge commit `b204386` (#18) from `kaushik-IDE`.

The Cursor Cloud `AGENTS.md` documentation is being relocated onto
**main** via #19. This PR
removes the duplicate section from Kaushik's branch so it no longer
carries Cloud-env docs that belong on `main`.

## Changes

- `AGENTS.md`: remove `## Cursor Cloud specific instructions` (62 lines)
— revert of #18

No application code changes.
<!-- CURSOR_AGENT_PR_BODY_END -->

<div><a
href="https://cursor.com/agents/bc-8ce91e70-c67b-48c6-84b3-05bb9d06231a?cursor_ref=pr_footer&cursor_cta=open_in_web"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://cursor.com/assets/images/open-in-web-dark.png"><source
media="(prefers-color-scheme: light)"
srcset="https://cursor.com/assets/images/open-in-web-light.png"><img
alt="Open in Web" width="114" height="28"
src="https://cursor.com/assets/images/open-in-web-dark.png"></picture></a>&nbsp;<a
href="https://cursor.com/background-agent?bcId=bc-8ce91e70-c67b-48c6-84b3-05bb9d06231a&cursor_ref=pr_footer&cursor_cta=open_in_cursor"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://cursor.com/assets/images/open-in-cursor-dark.png"><source
media="(prefers-color-scheme: light)"
srcset="https://cursor.com/assets/images/open-in-cursor-light.png"><img
alt="Open in Cursor" width="131" height="28"
src="https://cursor.com/assets/images/open-in-cursor-dark.png"></picture></a>&nbsp;</div>

Co-authored-by: Cursor Agent <cursoragent@cursor.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