← Back to videos

Use a Symlink to Sync AI Context Files Across Tools (CLAUDE.md, agents.md)

@its.mikareyesCapturedClaude Code / Skills
See more in Claude Code / Skills

Exact instruction

  1. Create one master file (suggested: agents.md — 60k+ GitHub projects already use this format).
  2. Symlink CLAUDE.md → agents.md: `ln -s agents.md CLAUDE.md`
  3. Symlink any other AI tool config files to the same master.
  4. 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 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.