Set up Cursor Cloud development environment

[lucaspar]

Summary

Sets up the Cloud Agent development environment for this monorepo and validates it end-to-end against the core product (the Gateway Django web app + REST API). Adds an AGENTS.md with durable, non-obvious startup/run caveats for future agents. The only code change is the new AGENTS.md; all other setup is captured in the VM environment (system deps) and the startup update script (host uv deps).

What was installed

• Docker Engine + Compose plugin (docker-in-docker with fuse-overlayfs storage driver, containerd-snapshotter disabled for Docker 29, iptables-legacy).
• just, uv (symlinked into /usr/local/bin), postgresql-client, and libpq-dev/build-essential (needed to build psycopg[c] in the host uv venv).
• Host uv virtualenvs for gateway (--extra local) and sdk.

Update script (startup dependency refresh)

uv sync --project gateway --extra local --frozen
uv sync --project sdk --frozen

Services / verification

The Gateway local stack was deployed via SDS_SKIP_SFS=true ./scripts/deploy.sh local (RustFS is the local primary S3 store; SeaweedFS is an optional secondary and is skipped locally). All required services came up: Django app, Postgres, Redis, OpenSearch, RustFS, Celery worker + beat, node/webpack, nginx.

Check	Command	Result
Lint	just pre-commit	✅ all hooks pass
Python tests	just test-py	✅ 593 passed
JS tests	just test-js	✅ 607 passed
Run + hello-world	SDS_SKIP_SFS=true ./scripts/deploy.sh local	✅ logged in, generated API key

Hello-world walkthrough

Logged in to the web UI at http://localhost:8000 and generated an API key (the core Gateway↔SDK action).

gateway_login_and_generate_api_key.mp4

Logged-in API Keys page
Generated API key success page

Known non-blocking caveat

sds-gateway-local-nginx reports unhealthy only because its healthcheck wget http://localhost/healthz resolves to IPv6 ::1 while nginx listens on IPv4 0.0.0.0:80. nginx serves correctly over IPv4 and the app is reached directly on port 8000. Documented in AGENTS.md.

_{To show artifacts inline, enable in settings.}

  

[semanticdiff-com]

Review changes with