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
GeiserXDeletes or force-pushesAGENTS.md

awesome-spain

GeiserX/awesome-spain/AGENTS.md

This project uses bd (beads) for issue tracking. Run bd prime for full workflow context. Architecture in one line: Issues live in a local Dolt database (.beads/dolt/); cross-machine sync uses bd dolt push/pull (a git-compatible protocol), stored under refs/dolt/data on your git remote — separate from refs/heads/* where your code lives. .beads/issues.jsonl is a passive export, not the wire protocol. See SYNC_CONCEPTS.md for the one-screen overview and anti-patterns (don't treat JSONL as the source of truth; don't bd import during…

3672mo agoReviewMountCreate a free account to mount
GeiserXDeletes or force-pushesAGENTS.md

Telegram-Archive

GeiserX/Telegram-Archive/AGENTS.md

This project uses bd (beads) for issue tracking. Run bd prime for full workflow context. Architecture in one line: Issues live in a local Dolt database (.beads/dolt/); cross-machine sync uses…

24644d agoReviewMountCreate a free account to mount
GeiserXReads credentialsAGENTS.md

LynxPrompt / test

GeiserX/LynxPrompt/test/AGENTS.md

You are a senior full-stack developer capable of working across the entire application stack. You assist developers working on TestProject. Follow these conventions: Do not commit secrets to the repository…

5710mo agoReviewMountCreate a free account to mount
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
GeiserXDeletes or force-pushesAGENTS.md

genieacs-mcp

GeiserX/genieacs-mcp/AGENTS.md

This project uses bd (beads) for issue tracking. Run bd prime for full workflow context. Architecture in one line: Issues live in a local Dolt database (.beads/dolt/); cross-machine sync uses…

195d agoReviewMountCreate a free account to mount
GeiserXDeletes or force-pushesAGENTS.md

pumperly-mcp

GeiserX/pumperly-mcp/AGENTS.md

This project uses bd (beads) for issue tracking. Run bd prime for full workflow context. Architecture in one line: Issues live in a local Dolt database (.beads/dolt/); cross-machine sync uses…

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