agentleFS
Sign inSign up

AGENTS.md examples from real projects

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

Popular:code reviewtestingpdfMCP serverfrontendsecuritydocumentation
Best matches · from page 9Worked for most · soon
“MCP server” remove filterHugging Face remove filter
TencentCloudAGENTS.md

Octop

TencentCloud/Octop/AGENTS.md

agents/`, `api/routers/workspace*.py` | | `infra/connectors/` | Connector catalog, OAuth, MCP gateway, credential crypto | `api/routers/connectors.py`, `internal_mcp.py`, `agents/manager.py` (MCP assembly) | | `infra/cron/` | Cron jobs, triggers, agent tool hooks | `server.py`, `api/routers/cron.py` | | `infra/db/` | `SqlitePool`, migrations, `RepoBundle` / `SharedServices

5.4k35d agoDiscuss
GitHubAGENTS.md

gh-aw

github/gh-aw/AGENTS.md

manually. 7. **Large-file guard**: before reading any file with `github-mcp-server-get_file_contents`, check its size. Files larger than 20 KB must be read with targeted tools

5.2k4mo agoDiscuss
Model Context ProtocolAGENTS.md

go-sdk

modelcontextprotocol/go-sdk/AGENTS.md

Packages - `mcp`: The core package defining the primary APIs for constructing and using MCP clients and servers. This is where most logic resides. - `jsonrpc`: Provides the JSON-RPC 2.0 transport

5.2k7mo agoDiscuss
SaladDayAGENTS.md

cc-switch-cli

SaladDay/cc-switch-cli/AGENTS.md

tool for Claude Code, Codex, Gemini, OpenCode, Hermes, and OpenClaw. It manages provider configurations, MCP servers, prompts, skills, WebDAV sync, local proxy routes, failover, daemon/start flows, deep-link imports, workspace

5.1k18d agoReads credentialsDiscuss
clideyAGENTS.md

whodb

clidey/whodb/AGENTS.md

browser AI agent feature (under `ee/`), NOT the coding-agent (Claude/Codex) configuration or any MCP server. When in doubt, ask which is meant before acting. ## Non-Negotiable Rules 1. **GraphQL

5k6d agoDiscuss
MistralAGENTS.md

mistral-vibe

mistralai/mistral-vibe/AGENTS.md

subagents, hooks, MCP, connectors, custom tools, or discovery | [0007 Extension Mechanisms](docs/adr/0007-extension-mechanisms.md) | | Adding or changing analytics instrumentation, telemetry events, or event properties | [0008 Feature Instrumentation](docs/adr/0008-feature-instrumentation.md) | | App-server ownership, RPCs

5k41d agoDiscuss
WaishnavAGENTS.md

devspace

Waishnav/devspace/AGENTS.md

currently provides mature local coding primitives. DevSpace wraps those primitives in a Streamable HTTP MCP server and adds the product-specific boundaries around them: approved roots, workspace state, instructions, process

5k3mo agoDiscuss
homeassistant-aiAGENTS.md

ha-mcp

homeassistant-ai/ha-mcp/AGENTS.md

AGENTS.md Canonical agent guidance for the Home Assistant MCP Server repository. ## Instruction structure - `AGENTS.md` is the canonical source. `CLAUDE.md` is a symlink to it; edit `AGENTS.md` only. - This root file

4.9k5d agoDiscuss
homeassistant-aiAGENTS.md

ha-mcp / homeassistant-addon-webhook-proxy

homeassistant-ai/ha-mcp/homeassistant-addon-webhook-proxy/AGENTS.md

stable + dev) ## What it is A thin add-on that does NOT run an MCP server. It discovers a running ha-mcp server add-on (stable `ha_mcp`, then

4.9k5d agoDiscuss
homeassistant-aiAGENTS.md

ha-mcp / tests

homeassistant-ai/ha-mcp/tests/AGENTS.md

skips everywhere else. `src/e2e/workflows/filesystem/test_tools_entry_absent.py` is the module that carries it. The server entry also registers the `ha_mcp_tools/*` WebSocket surface (#2291), so on the two `embedded` shapes the shared

4.9k5d agoDiscuss
mvanhornAGENTS.md

cli-printing-press

mvanhorn/cli-printing-press/AGENTS.md

runtime walker in `internal/mcp/cobratree/` mirrors the Cobra tree at server start and registers every user-facing command as an MCP tool unless one of these applies: 1. Commands annotated `cmd.Annotations

4.8k5mo agoDiscuss
u14appAGENTS.md

deep-research

u14app/deep-research/AGENTS.md

Custom React hooks for business logic and state interaction. - `src/libs`: External service integrations (e.g., MCP server logic). - `src/store`: Zustand stores for global state and persistence. - `src/utils`: Helper functions and core

4.7k17mo agoReads credentialsDiscuss
breferrariAGENTS.md

obsidian-mind

breferrari/obsidian-mind/AGENTS.md

notes are the source of truth. ## Reaching this vault from another repo The `om` MCP server (`.claude/scripts/om-mcp.mjs`) exposes this vault over MCP, so a session running in a **different repository

4.6k45d agoDiscuss
SupabaseAGENTS.md

supabase-js

supabase/supabase-js/AGENTS.md

Coding Agents](https://supabase.com/docs/guides/getting-started/plugins) to install the agent skills together with the Supabase MCP server in one step. See also: [Agent Skills documentation](https://agentskills.io/home). ## Migration notes Migration

4.6k6mo agoDiscuss
SupabaseAGENTS.md

supabase-js / auth-js

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

agent skills](https://github.com/supabase/agent-skills): `npx skills add supabase/agent-skills`. Or pair with the Supabase MCP server via the [Supabase Plugin for AI Coding Agents](https://supabase.com/docs/guides/getting-started/plugins).

4.6k6mo agoDiscuss
SupabaseAGENTS.md

supabase-js / functions-js

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

agent skills](https://github.com/supabase/agent-skills): `npx skills add supabase/agent-skills`. Or pair with the Supabase MCP server via the [Supabase Plugin for AI Coding Agents](https://supabase.com/docs/guides/getting-started/plugins).

4.6k6mo agoDiscuss
SupabaseAGENTS.md

supabase-js / postgrest-js

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

agent skills](https://github.com/supabase/agent-skills): `npx skills add supabase/agent-skills`. Or pair with the Supabase MCP server via the [Supabase Plugin for AI Coding Agents](https://supabase.com/docs/guides/getting-started/plugins).

4.6k6mo agoDiscuss
SupabaseAGENTS.md

supabase-js / realtime-js

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

agent skills](https://github.com/supabase/agent-skills): `npx skills add supabase/agent-skills`. Or pair with the Supabase MCP server via the [Supabase Plugin for AI Coding Agents](https://supabase.com/docs/guides/getting-started/plugins).

4.6k6mo agoDiscuss
SupabaseAGENTS.md

supabase-js / storage-js

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

agent skills](https://github.com/supabase/agent-skills): `npx skills add supabase/agent-skills`. Or pair with the Supabase MCP server via the [Supabase Plugin for AI Coding Agents](https://supabase.com/docs/guides/getting-started/plugins).

4.6k6mo agoDiscuss
SupabaseAGENTS.md

supabase-js / supabase-js

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

agent skills](https://github.com/supabase/agent-skills): `npx skills add supabase/agent-skills`. Or pair with the Supabase MCP server via the [Supabase Plugin for AI Coding Agents](https://supabase.com/docs/guides/getting-started/plugins).

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