From 3be15fef5bc98c46225bbd5b35703482f361cc73 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Thu, 2 Apr 2026 20:20:12 +0000 Subject: [PATCH] Add AGENTS.md with Cursor Cloud specific instructions for PostgreSQL 16 setup Co-authored-by: ccycv --- AGENTS.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..460d420 --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,32 @@ +# AGENTS.md + +## Cursor Cloud specific instructions + +This repository contains a single `postgresql.conf` configuration file for **PostgreSQL 16**. + +### Service overview + +| Service | Details | +|----------------|---------| +| PostgreSQL 16 | The only service. Config lives at repo root `postgresql.conf`. | + +### Starting PostgreSQL + +```bash +sudo cp /workspace/postgresql.conf /etc/postgresql/16/main/postgresql.conf +sudo chown postgres:postgres /etc/postgresql/16/main/postgresql.conf +sudo pg_ctlcluster 16 main start +``` + +### Key non-default config values + +- `port = 5432` +- `max_connections = 1000` +- `shared_buffers = 128MB` +- `ssl = on` (uses snakeoil certs at `/etc/ssl/certs/ssl-cert-snakeoil.pem`) + +### Gotchas + +- The `ssl = on` setting requires the `ssl-cert` snakeoil certificates. The `postgresql-16` Ubuntu package automatically adds the `postgres` user to the `ssl-cert` group, so this works out of the box after `apt-get install postgresql-16`. +- There are no application-level tests, lint, or build steps in this repo — only the PostgreSQL config file. Validation means confirming `SHOW` commands return the expected values after starting PG with this config. +- Use `sudo -u postgres psql` to connect (peer auth by default via `pg_hba.conf`).