panishandsome/ai-rules-sync

Different AI coding tools each read their instructions from a different file. Codex reads a file called AGENTS.md. Claude Code reads CLAUDE.md. Cursor reads .cursorrules. GitHub Copilot reads a file inside a .github folder. If you use more than one of these tools in the same project, you end up maintaining the same instructions in multiple files, and they tend to drift apart over time. Agentsync solves this by letting you keep one file as the single source of truth and generating the others from it automatically. You run a setup command once, point it at your repo, and it creates an AGENTS.md, writes a configuration file listing which other files to generate, and installs a pre-commit hook so the generated files stay in sync every time you commit. After that you only edit AGENTS.md, the tool handles the rest. The tool also handles the reverse: if you already have several rule files and want to consolidate them, a merge command combines them into one. A convert command translates any supported format into any other. A generate command creates a fresh AGENTS.md from a short description of your project, including the language, framework, and test commands. A lint command checks an existing file for stale commands or paths that no longer exist in the repository. For situations where you want to keep using whichever file your current tool prefers rather than standardizing on AGENTS.md, an auto mode tracks which file changed since the last sync and regenerates the others from it. The supported tools include Codex, Claude Code, Cursor, GitHub Copilot, Windsurf, Cline, Aider, Gemini CLI, and Qwen Code. The conversion works by parsing each format into a shared internal structure and then rendering that structure into the target format. Constructs that have no equivalent in the target format produce warnings rather than being silently dropped. The package has no external dependencies and can be installed globally via npm or run directly with npx. A browser playground is available for trying conversions without installing anything.