agentleFS
Sign inSign up

AGENTS.md examples from real projects

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

Best matches · from page 2Worked for most · soon
clideyAGENTS.md

whodb

clidey/whodb/AGENTS.md

need both env and log src/plugins/ # Database connectors (each has init() calling engine.RegisterPlugin) # Includes: postgres, mysql, sqlite3, mongodb, redis, elasticsearch, # clickhouse, duckdb, memcached (+ mariadb via mysql) graph/schema.graphqls # GraphQL schema graph

5k9d agoDiscuss
Agenta-AIAGENTS.md

agenta

Agenta-AI/agenta/AGENTS.md

services` (`py-run-tests` = `uv sync --locked && uv run --no-sync python run-tests.py`). - Postgres is reachable locally with `username:password`; EE DB name is `agenta_ee_core`. - Tests mint ephemeral

4.8k2mo agoReads credentialsDiscuss
Agenta-AIAGENTS.md

agenta / api

Agenta-AI/agenta/api/AGENTS.md

business orchestration - DB layer: `api/oss/src/dbs/postgres/ /` - `dbes.py`: SQLAlchemy entities - `dbas.py`: shared mixins (when needed) - `dao.py`: Postgres implementation - `mappings.py`: DTO <-> DBE mapping Example to copy: - `api/oss/src/apis/fastapi/workflows/` - `api/oss/src/core/workflows/` - `api/oss/src/dbs/postgres/workflows/` ### Database schema migrations (which

4.8k2mo agoDiscuss
SupabaseAGENTS.md

supabase-js / realtime-js

supabase/supabase-js/packages/core/realtime-js/AGENTS.md

Listen to realtime updates from a Supabase PostgreSQL database. Handles channels, presence, broadcast, and Postgres CDC subscriptions. When helping a user work with this package: - **Usage and quick start**: [`README.md

4.6k6mo agoDiscuss
archestra-aiAGENTS.md

archestra / platform

archestra-ai/archestra/platform/AGENTS.md

# Individual Preferences - Read `CLAUDE_LOCAL.md` in this directory if it exists (untracked individual preferences). ## Working

4.3k6d agoReads credentialsDiscuss
crafter-stationAGENTS.md

petdex

crafter-station/petdex/AGENTS.md

users only. - Recommended local app dev is `bun run dev:docker`; it boots local Postgres and Redis with shared Clerk dev defaults from `.env.dev`. - Maintainer dev is `bun dev` with

4.2k5mo agoReads credentialsDiscuss
melgarafaelAGENTS.md

DeskcommCRM

melgarafael/DeskcommCRM/AGENTS.md

React 19 · TypeScript 6 estrito · Tailwind 4 (config em CSS) · shadcn/ui (`new-york`) · Supabase (Postgres + Auth + Realtime + Storage) · Zod 4 · Vitest 4 · Playwright 1 · Sentry 11 · WAHA 2026.7.2 (engine NOWEB

4.2k15d agoReads credentialsDiscuss
basicmachines-coAGENTS.md

basic-memory

basicmachines-co/basic-memory/AGENTS.md

Test Commands - Install: `just install` or `pip install -e ".[dev]"` - Run all tests (SQLite + Postgres): `just test` - Run all tests against SQLite: `just test-sqlite` - Run all tests against Postgres

4.1k3mo agoReads credentialsDiscuss
yvgudeAGENTS.md

lean-ctx

yvgude/lean-ctx/AGENTS.md

task")` with current status ## Provider Pipeline (Context Engine) External data sources (GitHub, GitLab, Jira, Postgres, MCP bridges, custom REST) are first-class citizens. All provider data flows through the same

3.8k2mo agoDiscuss
AtmosphereAGENTS.md

atmosphere

Atmosphere/atmosphere/AGENTS.md

modules/` for the relevant family (e.g., CheckpointStore backends: `InMemory` + `Sqlite` ship in `modules/checkpoint/src/main/**`, and `Postgres` ships as the separate `modules/checkpoint-postgres` reactor module; Redis is pluggable

3.8k9d agoDiscuss
memodb-ioAGENTS.md

Acontext / landingpage

memodb-io/Acontext/landingpage/AGENTS.md

prevent infinite hook loops 3. Enable transactions for MongoDB (requires replica set) and Postgres 4. Use `beforeValidate` for data formatting 5. Use `beforeChange` for business logic ### Type Safety

3.7k7mo agoReads credentialsDiscuss
ObservalAGENTS.md

Observal

Observal/Observal/AGENTS.md

migrations** live in `observal-server/clickhouse/migrations/*.sql` and run through `services.clickhouse.migrations`. Keep Alembic for Postgres only. Never add ClickHouse DDL to startup code. The init container runs ClickHouse migrations after

3.7k2mo agoDiscuss
doscoAGENTS.md

graphjin

dosco/graphjin/AGENTS.md

against an expected string. 4. **Dialect Compatibility**: If the feature syntax varies by database (Postgres vs MySQL): - Add a method to the `Dialect` interface in `core/internal/dialect`. - Implement it in `postgres.go

3.2k33d agoReads credentialsDiscuss
crbnosAGENTS.md

carbon

crbnos/carbon/AGENTS.md

Framework**: React Router v7 (NOT Remix), flat routes via `remix-flat-routes` - **Database**: Supabase (Postgres) with RLS, typed via `@carbon/database` + Kysely - **Background jobs**: Inngest (NOT Trigger.dev), via `@carbon/jobs` - **Apps

2.6k6d agoDiscuss
VercelAGENTS.md

workflow

vercel/workflow/AGENTS.md

credentials are required: ```bash pnpm run test:e2e:event-log-race-repro:local # world-postgres pnpm run test:e2e:event-log-race-repro:local --world local # world-local ``` The script

2.4k12mo agoReads credentialsDiscuss
VercelAGENTS.md

chat / state-memory

vercel/chat/packages/state-memory/AGENTS.md

interface, update this file first — the test cases here become the spec the Redis / Postgres adapters must also satisfy. ## Coding conventions - Use named exports throughout. No default exports

2.4k2mo agoDiscuss
VercelAGENTS.md

chat / state-pg

vercel/chat/packages/state-pg/AGENTS.md

state in PostgreSQL using the [`pg`](https://www.npmjs.com/package/pg) client. Pick this adapter when: - Postgres is already your primary datastore and you don't want to add Redis

2.4k2mo agoDiscuss
SupabaseAGENTS.md

etl

supabase/etl/AGENTS.md

Repository Guidelines Postgres logical-replication engine. `etl` is the library, `etl-replicator` is the standalone binary, and `etl-destinations` holds built-in destinations. Product docs: https://supabase.github.io/etl/. Human walkthrough

2.3k11d agoDiscuss
DicklesworthstoneAGENTS.md

mcp_agent_mail

Dicklesworthstone/mcp_agent_mail/AGENTS.md

docs/mcp_protocol_specs.md` for any questions about the MCP protocol in general. For anything relating to Postgres, be sure to read `third_party_docs/POSTGRES18_AND_PYTHON_BEST_PRACTICES.md`. We load all configuration details from the existing

2.2k4mo agoPipes a download into a shellDiscuss
Kritt-aiAGENTS.md

open-kritt

Kritt-ai/open-kritt/AGENTS.md

Express + Prisma (npm) | | `engine/` | Scan worker running the AI harnesses | Python 3.11+ (Ruff) | | `database/` | Postgres image + `init/*.sql` migrations | Postgres 16 | | `executor-view/` | Executor viewer | Python | | `scripts/` | Repo tooling

2.2k3mo 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.