Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
32 changes: 32 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -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`).