Kick off your book project in 2 hours! Live workshop on Zoom. You’ll leave with a real book project, progress on your first chapter, and a clear plan to keep going. Tuesday, June 16, 2026. Learn more…

Leanpub Header

Skip to main content

Claude Code AGENTS.md Interop Handbook

One instruction file across Claude Code, Codex, Copilot, Cursor, Gemini CLI, and more — verified setup, copy-paste templates, rollback-safe migration.

This book is 100% completeLast updated on 2026-06-04

Minimum price

$9.99

$12.99

You pay

Author earns

$

Also available for 1 book credit with a Reader Membership

PDF
About

About

About the Book

Stop maintaining CLAUDE.md and AGENTS.md as two files that drift apart. Claude Code reads CLAUDE.md; Codex, Amp, and GitHub Copilot read AGENTS.md natively; Cursor, Windsurf, and Cline read their own files; Aider and Gemini CLI read AGENTS.md only after you configure them. That gap is the single largest open feature request in Claude Code — issue #6235, 5,200+ reactions, still unaddressed nine months on — and a duplication tax on everyone who runs more than one AI coding tool. This handbook removes it: a verified 9-tool matrix (which file each tool reads, whether it needs setup, and the one thing to watch, checked against every tool's official docs on 2026-06-02); six sync paths ranked by trade-off (the official @AGENTS.md import, symlink, pre-commit sync, SessionStart hook, direnv, CI drift check); copy-paste templates for all nine tools plus a complete repo layout; a rollback-safe migration runbook to move CLAUDE.md to AGENTS.md without losing Claude-only behavior; and a team drift guard that makes divergence fail loudly. 21 pages, dense and practical, with free updates as conventions change. By an independent operator who runs Claude Code 800+ hours and maintains cc-safe-setup (free MIT hooks, 1,700+ users). Try the free AGENTS.md Setup Generator and field-guide Gist first; buy this for the full matrix, the runbook, and the templates in one place. Independent handbook — not affiliated with Anthropic, OpenAI, GitHub, or Google.

Share this book

Author

About the Author

The Leanpub 60 Day 100% Happiness Guarantee

Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

See full terms...

Earn $8 on a $10 Purchase, and $16 on a $20 Purchase

We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.

(Yes, some authors have already earned much more than that on Leanpub.)

In fact, authors have earned over $15 million writing, publishing and selling on Leanpub.

Learn more about writing on Leanpub

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!

Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.

Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.

Learn more about writing on Leanpub