AGENTS.md examples from real projects

How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.

Best matchesWorked for most · soon

n8n-ioAGENTS.md

n8n

n8n-io/n8n/AGENTS.md

backend with PostgreSQL, Redis, email, and proxy services | `pnpm --filter n8n-containers services --services postgres,redis,mailpit,proxy`, then `pnpm dev:be` | | Add editor hot reload | `pnpm dev:fe:editor

206k22d agoReads credentialsDiscuss

Significant-GravitasAGENTS.md

AutoGPT

Significant-Gravitas/AutoGPT/AGENTS.md

available use `unknown` ## Testing - Backend: `poetry run test` (runs pytest with a docker based postgres + prisma). - Frontend integration tests: `pnpm test:unit` (Vitest + RTL + MSW, primary testing approach). - Frontend

188k22d agoDiscuss

SupabaseAGENTS.md

supabase

supabase/supabase/AGENTS.md

111k10d agoDiscuss

bytedanceAGENTS.md

deer-flow / backend

bytedance/deer-flow/backend/AGENTS.md

scheduler.multi_instance=true` opts into lease-aware recovery across Gateway instances and requires shared Postgres, `run_ownership.heartbeat_enabled=true`, and `run_events.backend=db`; otherwise startup rejects the configuration. Live scheduled runs

83k3mo agoDiscuss

amruthpillaiAGENTS.md

reactive-resume

amruthpillai/reactive-resume/AGENTS.md

env.local`. Three required vars: `APP_URL` (default `http://localhost:3000`), `DATABASE_URL` (default `postgresql://postgres:postgres@localhost:5432/postgres`), `AUTH_SECRET` (any non-empty string). - **S3/SeaweedFS optional.** If `S3_ACCESS

43k21d agoReads credentialsDiscuss

LangChainAGENTS.md

langgraph

langchain-ai/langgraph/AGENTS.md

libraries. Below is a high-level overview: - **checkpoint** – base interfaces for LangGraph checkpointers. - **checkpoint-postgres** – Postgres implementation of the checkpoint saver. - **checkpoint-sqlite** – SQLite implementation of the checkpoint saver

42k40d agoDiscuss

BlockAGENTS.md

buzz

block/buzz/AGENTS.md

huddle audio buzz-core # Core types, event verification, filter matching, kind registry buzz-db # Postgres event store and data access layer buzz-auth # Authentication and authorization buzz-pubsub # Redis pub/sub

35k4mo agoReads credentialsDiscuss

topoteretesAGENTS.md

cognee

topoteretes/cognee/AGENTS.md

source of truth: `cognee/infrastructure/databases/dataset_database_handler/supported_dataset_database_handlers.py`): - Graph — supported: Ladybug/Kuzu (default), Neo4j (needs multi-database, i.e. Enterprise/Aura), Postgres (demo), Turso. Unsupported: Neptune, ladybug-remote. - Vector — supported: LanceDB (default), PGVector, Turso. Unsupported: Neptune Analytics

31k16d agoReads credentialsDiscuss

kestra-ioAGENTS.md

kestra

kestra-io/kestra/AGENTS.md

queue implementations - `queue-jdbc` - JDBC-based queue implementation **Data Layer:** - `jdbc-*` - Database implementations (H2, Postgres, MySQL) **Testing Modules:** - `e2e` - Playwright end-to-end suite, run against a Kestra docker image

28k22d agoReads credentialsDiscuss

BloopAIAGENTS.md

vibe-kanban

BloopAI/vibe-kanban/AGENTS.md

check` in CI) - Prepare SQLx (offline): `pnpm run prepare-db` - Prepare SQLx (remote package, postgres): `pnpm run remote:prepare-db` - Local NPX build: `pnpm run build:npx` then `pnpm pack

28k6mo agoReads credentialsDiscuss

triggerdotdevAGENTS.md

trigger.dev

triggerdotdev/trigger.dev/AGENTS.md

root. See `.claude/rules/package-installation.md` for the full process. ```bash pnpm run docker # Core dev services (Postgres, Redis, Electric, MinIO, ClickHouse, s2-lite) # pnpm run docker:full # Same + observability stack (Prometheus, Grafana

16k52d agoDiscuss

NevaMind-AIAGENTS.md

memU

NevaMind-AI/memU/AGENTS.md

service; do not add one. - Storage is pluggable across `inmemory`, `sqlite`, and `postgres`; repository contract changes require backend parity. - Scope data comes from `UserConfig.model`; validate `where` filters (`_normalize_where

14k9mo agoDiscuss

MemTensorAGENTS.md

MemOS

MemTensor/MemOS/AGENTS.md

12k4mo agoReads credentialsDiscuss

cocoindex-ioAGENTS.md

cocoindex

cocoindex-io/cocoindex/AGENTS.md

Rust extension module (update when PyO3 APIs change) │ │ ├── connectors/ # External system connectors (localfs, postgres, qdrant, lancedb, google_drive) │ │ ├── connectorkits/ # Connector building utilities │ │ ├── resources/ # Abstractions: file.py (FileLike), chunk.py (Chunk), schema.py

12k3mo agoDiscuss

cocoindex-ioAGENTS.md

cocoindex / examples

cocoindex-io/cocoindex/examples/AGENTS.md

blanks; both `python main.py` and the `cocoindex` CLI load `.env` automatically. Common ones: - `POSTGRES_URL` — for Postgres/pgvector targets. Local instance: `docker compose -f ../../dev/postgres.yaml up -d` from inside an example

12k3mo agoReads credentialsDiscuss

GoogleAGENTS.md

adk-recipes / long-horizon-harness

google/adk-recipes/core/python/long-horizon-harness/AGENTS.md

docs/sandbox-lifecycle.md. │ ├── scheduler/ # Cloud Scheduler (auth, dream-review/snapshot endpoints) + routines runtime (routine_store, routine_postgres_store, cron.py, routine_tick_endpoint). See "Scheduler" below + docs/routines.md. │ ├── secrets/ # Per-user secret store behind

10k54d agoReads credentialsDiscuss

CLAUDE.md vs AGENTS.md

About AGENTS.md

What is AGENTS.md?

An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.

Where does it go?

At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.

What should it contain?

Setup and test commands, code style, and the rules a new contributor would need to know.

Does Claude Code read it?

Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.