agentleFS

AGENTS.md examples from real projects

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

Worked for most · soon
NVIDIAAGENTS.md

cosmos

NVIDIA/cosmos/AGENTS.md

This is the landing repository for NVIDIA Cosmos: the README, the model reference and the Cosmos Cookbook, an index of agent-runnable recipes. Code, recipes and agent skills live in Cosmos…

Steady2 mentions in 2 weeks

No other project uses it yet

12k25d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

presidio

microsoft/presidio/AGENTS.md

Presidio is a Python SDK for detecting (presidio-analyzer) and anonymizing (presidio-anonymizer) PII in text and images, plus CLI, structured-data, and image-redaction components. It is a widely used library: users depend on current detection behavior, and configuration files written years ago must keep working. Correctness and backward compatibility outrank cleverness. The review-side versions of these rules — which the Copilot PR review agent also enforces — live in .github/copilot-instructions.md and .github/instructions/*.instructions.md. Follow them at authoring time; the pre-PR check below verifies…

12k8d agoReviewMountCreate a free account to mount
CloudflareReads credentialsAGENTS.md

cloudflare-os

cloudflare/cloudflare-os/AGENTS.md

This project is building a platform for "vibe coded" personal applications and AI agents that run inside a strong sandbox. The following files are commonly important to reference: Each of these holds rules this file does not repeat. Read the matching guide before changing, reviewing or answering questions about code under its directory: Reviewing a pull request: follow REVIEW.md as well.

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / configurator-ui

cloudflare/cloudflare-os/packages/configurator-ui/AGENTS.md

The authoring API (src/index.ts, type-only stubs) for optional gatekeeper resource configurator UI modules, the sandbox runtime that renders them (src/runtime/: Kumo components on preact/compat), and the build that bundles both into each configurator's frame (build/). - Gatekeeper configurator UI modules are compiled by scripts/build-gatekeeper-configurator.ts as part of package builds. Each frame is one self-contained HTML document: the minified runtime, its Tailwind/Kumo CSS, and the module, under a content security policy that admits only those scripts by hash and allows no…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / error-reporting

cloudflare/cloudflare-os/packages/error-reporting/AGENTS.md

@gadgets/error-reporting owns the vendor-neutral browser/Worker event contract and tolerant, bounded normalization for frontend error reports, a separate, opt-in path from server issue reporting (packages/observability/AGENTS.md). - VITE_FRONTEND_ERROR_REPORTING=true enables trusted frontend producers and their hidden source maps at build time; deployments without reporting should leave it unset. - The Workshop browser sends best-effort reports to the same-origin POST /api/client-errors endpoint. The backend dispatches only when both FRONTEND_ERROR_REPORTER and FRONTEND_ERROR_RATE_LIMITER are bound; otherwise the endpoint is an intentional no-op. - Gatekeeper management/configurator UIs…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / gatekeeper-cloudflare

cloudflare/cloudflare-os/packages/gatekeeper-cloudflare/AGENTS.md

Cloudflare OAuth, serving three unrelated purposes from one connected account — sign-in (AUTH_GATEKEEPERS), AI Gateway billing, and Workers Observability read-only telemetry resources. Two resource granularities (whole account, or one Worker) both map to the single indivisible workers-observability.read scope, so the capability boundary is the binding, not the grant. - Layering: observability-api.ts is the only place that talks HTTP; observability-parse.ts validates every response (no blind casts); observability-session.ts is the agent-facing session, where every read funnels through one #observe so no path…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / gatekeeper-context

cloudflare/cloudflare-os/packages/gatekeeper-context/AGENTS.md

The Context Library — a gatekeeper whose account provides a singleton read session + a management UI, for authoring collections of context documents that agents read as observations. plans/context-collection-sharing.md is the design record. - Collections have one of two visibilities: private (created by one account and shareable with others) and public (created/edited only by deployment admins, readable by everyone and auto-enabled for all users; not shareable). - It owns its state in three Durable Objects (ContextCollectionDurableObject for content and a…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / gatekeeper-kit

cloudflare/cloudflare-os/packages/gatekeeper-kit/AGENTS.md

@gadgets/gatekeeper-kit is a library, not a deployable Worker. Do not add a cloudflare.config.ts: the wrangler.jsonc generated from it is what makes release tooling treat this package as a gatekeeper deployment. - Only Layer 1 leaf modules are shipped. Layer 2 remains a proposal in ../../plans/gatekeeper-kit.md. - Keep leaf modules independently usable. Do not make one depend on a future assembly layer. - Add a leaf, or a leaf option, only for behavior several gatekeepers share under one contract. Behavior only…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / gatekeeper-microsoft

cloudflare/cloudflare-os/packages/gatekeeper-microsoft/AGENTS.md

Microsoft 365 (Entra ID OAuth, Microsoft Graph). It has three resources. SharePoint's binding is one of: all of SharePoint & OneDrive, a site, a library or OneDrive, a folder, a file, a list, or a page; its configurator starts at "all" and drills down. Outlook's is one mailbox (own or shared), optionally narrowed to a folder, a conversation or senders, at read/draft/send. Calendar's is every calendar (for chat), one calendar (own or shared) at freeBusy/limited/full detail (for a gadget shared…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / gatekeeper-websearch

cloudflare/cloudflare-os/packages/gatekeeper-websearch/AGENTS.md

Web Search — an auto-provisioned gatekeeper whose account provides an ambient WEB_SEARCH singleton. The README is the design record. - It searches the public web through its own Workers AI binding (websearch(), through the AI Gateway its CF_AI_GATEWAY var names, provider pinned to Ceramic). The deploy service sets that var to the instance's gateway, the backend's; anywhere else it defaults to the account's default gateway. - Each query is recorded as an observation before it is sent. A workspace that…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / gatekeeper-x

cloudflare/cloudflare-os/packages/gatekeeper-x/AGENTS.md

X (formerly Twitter) — account / post / List / read-only profile resources over plain fetch (the twitter-api-v2 package breaks on Workers). plans/x-gatekeeper.md is the design record. X's API is pay-per-use and bills every resource a read returns, so cost is part of the design and easy to undo by accident: - Every read goes through the gatekeeper's #read, which reserves against the connection's daily read limit (X_DAILY_READ_LIMIT, counted per UTC day in the UserAccount DO across all of the…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / mcp-shared

cloudflare/cloudflare-os/packages/mcp-shared/AGENTS.md

The shared implementation behind the two MCP gatekeepers — gatekeeper-mcp (endpoints a user pastes) and gatekeeper-mcp-portal (one admin-configured portal). Not a Worker; a library both import, holding the MCP client, the OAuth chain, the account DO base, the resource-URL scope grammar, and the queued-action store. See README.md and each connector's README. - The trust boundary is tools.ts, and nothing outside it reads a tool's annotations: a tool the server declares readOnlyHint: true runs as an observation, everything else is queued…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / observability

cloudflare/cloudflare-os/packages/observability/AGENTS.md

@gadgets/observability: server-side logging, issue reporting and usage metrics. Frontend browser console.* is out of scope, and frontend error reporting is packages/error-reporting/AGENTS.md. Server-side logging uses @gadgets/observability/logger: - Define a package-owned field type and module-scoped logger with a stable dot-separated component and, for gatekeepers, vendorId: const logger = createLogger<GitHubLogFields>({ component: "gatekeeper.github", vendorId: VENDOR_ID });. - Emit concrete event names and relevant typed fields, for example: logger.warn("failed to notify credential expiry", { event: "credentials.expiry.notify.failed", error: err });. Each call emits one indexed object;…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / ui

cloudflare/cloudflare-os/packages/ui/AGENTS.md

@gadgets/ui is the shared runtime React UI layer for the Workshop and gatekeeper management apps. Kumo owns low-level controls and semantic tokens; this package owns reusable Gadgets interaction patterns and composed components. - Add a component here when at least two independent frontends need the same feature-independent behavior or when consistency across those frontends is an explicit product requirement. - Keep product data fetching, routing, RPC, permissions, and domain workflows in the consuming app. - Check Kumo before adding a…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / workshop-backend

cloudflare/cloudflare-os/packages/workshop-backend/AGENTS.md

The Gadgets Workshop server on Cloudflare Workers: the kernel, held to the bar in the root AGENTS.md (The kernel). See ../../docs/worktree-replicas.md before changing worktree Git transport or replica synchronization. A replica's sync must keep step transactionality (see plans/tree-sync-replicas.md): the kernel only knows snapshots and submissions bound to an executeCode call. Guest paths, mount names, command approvals and process lifetimes belong to the gatekeeper. The backend installs the bundled blueprints from @gadgets/bundled-blueprints on a deployment's first /api request, and offers them…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / workshop-frontend

cloudflare/cloudflare-os/packages/workshop-frontend/AGENTS.md

This package is the Workshop single-page application. It uses React, TanStack Router, Tailwind, and Kumo. Follow the repository-wide guidance in ../../AGENTS.md in addition to this file. Organize new code by product ownership first and implementation type second. The existing tree predates this convention. Apply it to new code and to code being substantially reworked; do not migrate unrelated files opportunistically. Feature directories own product behavior. A feature may contain components, hooks, tests, and utilities that belong to that behavior. Start…

12k55d agoReviewMountCreate a free account to mount
CloudflareAGENTS.md

cloudflare-os / release

cloudflare/cloudflare-os/scripts/release/AGENTS.md

How customer instances get deployed. - build-release.ts bundles every deployable worker byte-identically (wrangler dry-run with the pinned wrangler), builds the Access-mode frontend asset build, and generates the release manifest — the contract between this repo's CI and the deploy service, produced by manifest-lib.ts from each package's wrangler.jsonc with account-specific values replaced by placeholders ($ACCOUNT_ID, $WORKER_NAME(...), $SECRET(...), $PUBLIC_BASE_URL, ...). - upload-release.ts mirrors the release to R2 content-addressed, manifest last; with --candidate the manifest lands under candidates/<id>/ (invisible to the deploy service)…

12k55d agoReviewMountCreate a free account to mount
GoogleAGENTS.md

osv-scanner

google/osv-scanner/AGENTS.md

This file outlines the guidelines and expectations for AI agents and automated assistants contributing to this repository. [!IMPORTANT] System Prompt / Instruction: If you are an AI agent reading this file, you must incorporate these guidelines into your operating context. You are acting as an AI contributor to the OSV project. Before requesting review, ensure these pass: - Coverage: New features, bug fixes, or refactors must have relevant tests (unit, integration, or snapshot). - Snapshots: If modifying behavior affecting snapshots,…

Steady4 mentions in 2 weeks

No other project uses it yet

12k26d agoReviewMountCreate a free account to mount
GoogleAGENTS.md

go-github

google/go-github/AGENTS.md

Guidance for AI coding agents working in this repository. See CONTRIBUTING.md for everything you need, in particular:

Steady3 mentions in 2 weeks

No other project uses it yet

11k4mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

winget-pkgs

microsoft/winget-pkgs/AGENTS.md

Follow .github/copilot-instructions.md for repository-specific development guidance. Before filing a GitHub issue in this repository: Before opening a pull request:

11k7mo agoReviewMountCreate a free account to mount
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.