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

akou

GeiserX/akou/AGENTS.md

Conventions for anyone, human or agent, working in this repository. The design is in docs/DESIGN.md; read docs/index.md first. One package. Follow the layout in DESIGN section 10 exactly. This project…

1948d agoReviewMountCreate a free account to mount
GeiserXAGENTS.md

akou

GeiserX/akou/docs/agents.md

akou is built so your own terminal agent can do anything you can do in the window: start a call, follow it as it runs, answer questions from it, name…

1948d agoReviewMountCreate a free account to mount
GeiserXAGENTS.md

biblical-atlas-mcp

GeiserX/biblical-atlas-mcp/AGENTS.md

biblical-atlas-mcp is a Go MCP server for the biblical-atlas Bible atlas. It downloads the atlas's public data file (https://biblical-atlas.geiser.cloud/data.json), indexes it in memory and answers ten read-only tools. The design is in docs/design/DESIGN.md; read it before changing behaviour. User docs are in docs/. This project uses bd (beads) for issue tracking. Run bd prime to see full workflow context and commands. Architecture in one line: issues live in

238d agoReviewMountCreate a free account to mount
GeiserXAGENTS.md

vpn-bypass-mcp

GeiserX/vpn-bypass-mcp/AGENTS.md

MCP server (Go, stdio only, macOS only) for VPN Bypass. Each tool sends one request to the app's control socket and returns the app's result object unchanged. The app owns the contract. Its source of truth is in the VPN-Bypass repo: Sources/VPNBypassCore/CommandRouter.swift (Custom-mode verbs: status, mode, default, route.*, rule.*), ClassicControl.swift (the 4.9.0 domain.*, service.*, routes.*, refresh, dns.refresh and logs verbs; both hold their arguments and error codes), ControlSocketServer.swift (framing: one JSON line each way, 64 KiB per request line, 30…

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