Skip to content

Suggestion: agent-drift - detect diverged copies of CLAUDE.md and other instruction files #585

Description

@untactit

Category: Tools & Utilities

Repo: https://github.com/untactit/agent-drift

Suggested line, in the list's format:

  • agent-drift - Finds every AI agent instruction file under a path and reports which copies have diverged from each other.

What it does

Teams accumulate copies of CLAUDE.md, .claude/skills/*/SKILL.md, AGENTS.md and their equivalents across repositories and machines. When one copy is edited, nothing errors - the agent simply behaves differently there. This script finds those files, groups the ones that are the same document by content similarity rather than by filename, and reports the groups that hold more than one distinct version.

  • Single file, standard library only, Python 3.8+
  • Reads only; never writes to the files it scans
  • Covers Claude Code, Codex/AGENTS.md, Cursor, Copilot, Gemini, Windsurf, Cline, Aider, Continue, Zed
  • --fail-on-drift exits 1, so it can run in CI
  • --json output for post-processing
  • MIT licensed

On the star count

The repository is new and has no stars, so it does not fit the star-ordered position in that section. Placing it at the end, or holding it until it has traction, is entirely reasonable. I am submitting it because I could not find this gap covered elsewhere in the list, not to claim a position.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions