Use a Symlink to Sync AI Context Files Across Tools (CLAUDE.md, agents.md)
See more in Claude Code / Skills →Exact instruction
- Create one master file (suggested: agents.md — 60k+ GitHub projects already use this format).
- Symlink CLAUDE.md → agents.md: `ln -s agents.md CLAUDE.md`
- Symlink any other AI tool config files to the same master.
- Update only the master file; all tools auto-read the latest version.
Adopt?
Yes: Directly applicable if using Claude Code alongside any other AI coding tool. Create a master agents.md in each repo and symlink CLAUDE.md to it. Zero duplication, no platform lock-in.
Find the resource
Comment 'MIKA' on the original post (@its.mikareyes) for the exact symlink command + guide. Or just run: ln -s agents.md CLAUDE.md (from within your repo root).
show original captionhide original caption
comment MIKA for my practical guide on symlinks! My engineer husband explained what symlinks were so I didn't have to maintain and updatw separate context files that should basically have the same content. This is helpful if you're using both Claude and Codex or if you want to maintain files across both local and remote repos.