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

caveman

JuliusBrussee/caveman/AGENTS.md

Read CLAUDE.md before repository work. Binding routing: this repo owns skills, Engine, and MV3 extension; Agent SDK work belongs in /Users/julb/Desktop/GitHub/caveman-agent-sdk; Browse driver/MCP/benchmark/plugin work belongs in /Users/julb/Desktop/GitHub/caveman-browse; proprietary Pebble product work belongs in /Users/julb/Desktop/GitHub/caveman-coding-agent. Visibility: this repo and caveman-browse are public now; caveman-agent-sdk is private during development with planned public release after its gates; caveman-coding-agent and Caveman-Cloud remain private commercial source. @./skills/caveman/SKILL.md @./skills/caveman-commit/SKILL.md @./skills/caveman-review/SKILL.md @./skills/caveman-compress/SKILL.md

Steady7 mentions in 2 weeks

1 project uses a version of this

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeAGENTS.md

caveman / engine

JuliusBrussee/caveman/engine/AGENTS.md

Detect a payload's type → route to a safety-classed compressor → count the token reduction → store the original for recovery. The stable four-call API (Compress/Retrieve/Detect/Stats) is what the proxy, CLI, SDKs, MCP, and WASM build all share. Everything it reports is inferred; it never says verified.

Steady7 mentions in 2 weeks

1 project uses a version of this

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeAGENTS.md

caveman / extension

JuliusBrussee/caveman/extension/AGENTS.md

The consumer top-of-funnel: a toggle that, on ChatGPT / Claude / Gemini, prepends the caveman skill directive to each message you send and re-fires the send, so the AI replies in a compact, high-density style intended to preserve technical substance. It only ever adds text to your outgoing message; it never reads replies, never touches network requests. Savings are inferred. (This is the directive-injector product; an earlier revision shipped a local WASM compress button — EXT removed it after Chrome…

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeAGENTS.md

caveman / mcp

JuliusBrussee/caveman/mcp/AGENTS.md

A thin stdio JSON-RPC adapter exposing the compression engine as five MCP tools to any host (Claude Code, Cursor, …). It owns only the MCP framing; all compression is the engine's, linked in-process (no subprocess, no drift). Local-only — it opens no network connection — and everything it reports is inferred, never verified.

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeAGENTS.md

caveman / mem

JuliusBrussee/caveman/mem/AGENTS.md

Durable, cross-session memory: remember / recall / supersede / history / forget. A local SQLite store holds the raw memories (the source of truth); recall ranks them with deterministic BM25 behind a conservative threshold and compresses each hit through the engine so the inferred token cost is honest and the dropped detail stays recoverable via CCR. Everything is inferred. See ../../CLAUDE.md (root) · ../engine/CLAUDE.md · ../mcp/CLAUDE.md

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeAGENTS.md

caveman / proxy

JuliusBrussee/caveman/proxy/AGENTS.md

A base-URL-swap reverse proxy: match → authenticate → inspect → byte-safe transform → upstream → meter. Single-operator, BYOK, zero cloud dependencies. It shares its provider adapters with the managed gateway (the managed gateway imports them from here). caveman start launches the caveman-proxy binary. - listener lifetime is not session lifetime: serve never exits because a wrapper, native session, heartbeat, or idle timer expires. Legacy CAVEMANNATIVEIDLE_TIMEOUT does not arm shutdown. The CLI never restarts a shared listener to change mode/recovery; an…

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeAGENTS.md

caveman / shrink

JuliusBrussee/caveman/shrink/AGENTS.md

Compress MCP/OpenAI tool definitions before they fill the context window. A thin Go wrapper over the engine's toolschema compressor: it drops annotation metadata (examples, titles, $comment, $schema) and reduces long descriptions to their lead plus every constraint-bearing sentence. It keeps every selection token (tool/parameter names, types, enums, required) and argument-construction value (default, const, $ref targets) byte-for-byte. Everything is inferred. Selection alone does not guarantee valid arguments. Short descriptions stay whole; long ones keep the lead plus every recognised constraint sentence…

Steady7 mentions in 2 weeks

No other project uses it yet

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