Set up Cursor Cloud dev environment + AGENTS.md

[matthewro7263-hub]

Summary

Sets up the Cel development environment for Cursor Cloud agents and documents the non-obvious startup steps in a new AGENTS.md. No application code is changed.

The app is a single Express process serving the API + React/Vite SPA on one port, backed by PostgreSQL. The main hurdle was that @neondatabase/serverless only talks to Postgres over a secure WebSocket and refuses plain local Postgres, so a small local Neon-compatible WSS→TCP proxy (baked into the VM snapshot, documented in AGENTS.md) bridges the driver to local Postgres without any code change.

What was set up (in the VM snapshot)

• pnpm install dependencies; Bun installed for the test runner; native canvas module compiled (cairo/pango libs).
• PostgreSQL 16 installed and started; cel DB + role created; full schema applied via drizzle-kit push.
• Local Neon WebSocket proxy (/home/ubuntu/neon-local-proxy.mjs) + self-signed cert; /workspace/.env configured (NODE_TLS_REJECT_UNAUTHORIZED=0 for the self-signed cert, dev only).

Update script

pnpm install (minimal dependency refresh; services/DB/proxy persist in the snapshot and are documented in AGENTS.md).

Verification

• pnpm check (typecheck) — pass
• bun test — 29/29 pass
• pnpm build — client + server bundle built
• pnpm dev — /ready returns {"db":"connected"}; signed up a user and created a project end-to-end via the UI.

Cel landing page
Dashboard with created project

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