Bye CLAUDE.Md

bye-CLAUDE.md

**English** | [简体中文](./README.zh-CN.md)

Patch your **locally installed** [Claude Code](https://code.claude.com/) binary so it reads **`AGENTS.md` / `AGENTS.local.md`** everywhere it used to read `CLAUDE.md` / `CLAUDE.local.md` — project root, `.claude/` subdirectory, nested subdirectories, user-global `~/.claude/`, `/memory`, the `#` memory shortcut, and `/init` generation, all in one pass.

One file in your repo instead of two. The [open standard](https://agents.md/) every other agent tool already reads — and the one Claude Code [declined to support](https://github.com/anthropics/claude-code/issues/6235) despite 5,000+ upvotes.

npx bye-claude.md patch

---

How it works

Claude Code ships as a Bun-compiled standalone executable. All of its memory-filename strings live inside that binary as plaintext literals — in both **ASCII** and, less obviously, **UTF-16LE** (128 hidden copies that a naive search-and-replace would miss).

Every replacement this tool makes is **byte-for-byte the same length**:

pattern	replacement	ASCII	UTF-16LE
CLAUDE.md	AGENTS.md	9 = 9	18 = 18
CLAUDE.local.md	AGENTS.local.md	15 = 15	30 = 30
claude.md	agents.md	9 = 9	—
claude.local.md	agents.local.md	15 = 15	—

Equal length is the whole trick: no offset, length prefix, or Bun module-table entry ever moves, so the patched binary stays structurally byte-identical apart from the renamed strings. Strings that must not change — `CLAUDE_CODE_DISABLE_CLAUDE_MDS`, telemetry event names, the `~/.claude` directory, `.claude/rules/` — never match the patterns and are left alone.

The current release (2.1.246) contains 446 occurrences across the 8 patterns; see [`versions.json`](versions.json) for per-version anchors.

What you get after patching

• Reads: root AGENTS.md, .claude/AGENTS.md, nested sub/AGENTS.md, AGENTS.local.md, user-global ~/.claude/AGENTS.md
• Writes follow automa