with all optional extras (incl. memory)
just install-extra # e.g. just install-extra postgres
just install-memory # memory extra (lancedb + sentence-transformers)
just install-local # engine dev: uv sync + build
/gradlew :exposed-r2dbc-tests:test_h2_v2 # R2DBC Tests with H2
```
#### Test with Postgres
```bash
./gradlew test_postgres # All modules with Postgres
./gradlew :exposed-tests:test_postgres # JDBC Tests with
used by local dev / the Supabase CLI.
2. **AWS AMIs** — the production Supabase-hosted Postgres image, built via
Nix + Packer + Ansible.
3. **Nix packages** — `nix build .#psql_15.bin` etc., the underlying
guidance to Claude Code (claude.ai/code) when working with code in this repository.
## Overview
postgres-meta is a RESTful API for managing PostgreSQL databases. It provides a normalized interface over
First-time setup after clone
```bash
bun install
bun run dev # zero-config: embedded Postgres (pglite), server + web concurrently
```
Or self-host via Docker: `docker compose up` (real Postgres, port
Production server on port 8000
just test # Run pytest with marker (e.g., just test postgres)
just lint # ruff format check + ruff check
just format # ruff auto-fix + taplo
```
Available test
onto_ingest`). DuckDB acts as a federation backbone via its `httpfs`/`parquet`/`csv`/`postgres_scanner`/`iceberg` extensions. Connection strings: `postgres://…`, `duckdb:///path.duckdb`, `:memory:`, or `*.duckdb` file path. |
| `onto
Next rewrite to the backend.
- `backend/` - Bun + Hono + Postgres/Drizzle control plane: event-sourced
runs/steps (Postgres is the source of truth), replaceable engine adapters
(`src/engines/`) spawned one-shot per run, worker
generates keys/TLS + the dev-idp RSA key, starts the Docker infra, and runs the Postgres + ClickHouse migrations and finally starts all local services. Run it per session after starting
A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.
Where does it go?
At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.
What should it contain?
Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.
CLAUDE.md or AGENTS.md?
Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.