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 matchesWorked for most · soon
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

telemetry constants, feature flags | | `packages/api-types` | Generated platform Management API types | | `packages/pg-meta` | SQL builders for Postgres introspection (`SafeSqlFragment`) | | `packages/shared-data` | Static data: pricing, plans, regions, error codes | | `e2e/studio`, `e2e/docs` | Playwright E2E tests

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
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
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
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
OpenAIAGENTS.md

plugins / supabase-best-practices

openai/plugins/plugins/build-web-apps/skills/supabase-best-practices/AGENTS.md

Supabase Postgres Best Practices ## Structure ``` supabase-postgres-best-practices/ SKILL.md # Main skill file - read this first AGENTS.md # This navigation guide references/ # Detailed reference files ``` ## Usage 1. Read `SKILL.md

6.8k5mo agoDiscuss
weave-osAGENTS.md

router

weave-os/router/AGENTS.md

repos, Service.VerifyAPIKey, | | | | | | APIKeyCache, id/hashing, Tink | | | | | | encryptor) | | | | | | internal/billing (balance checks + inference | | | | | | debits: Service + Repo iface; | | | | | | Postgres impl in | | | | | | internal/postgres) | | | | | | internal/feedback (pure HMAC signer for the | | | | | | no-login feedback-link token

5.4k19d agoDiscuss
iflytekAGENTS.md

skillhub

iflytek/skillhub/AGENTS.md

management │ │ └── user/ # User-related auth services │ │ │ ├── skillhub-search/ # Search SPI + PostgreSQL full-text implementation │ │ ├── postgres/ # PostgresFullTextIndexService, QueryService │ │ └── service/ # Search SPI interfaces │ │ │ ├── skillhub-storage/ # Object storage SPI │ │ ├── local/ # LocalFileStorageService │ │ └── s3/ # S3StorageService

5.2k35d agoDiscuss
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 / 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
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
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
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

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