Rule-porter: convert your .mdc rules to CLAUDE.md, AGENTS.md, or Copilot

Showcase Built for Cursor
1

I built a small CLI that reads your .cursor/rules/ directory and outputs the equivalent config for other AI coding tools.

Someone on Dev.to asked if cursor-doctor could export rules to other formats, and I realized it’s actually a separate problem. Your .mdc files have frontmatter, globs, and alwaysApply flags, but none of that exists in CLAUDE.md or Copilot instructions. So converting isn’t just copy-paste. You have to make decisions about what to keep and what to lose.

npx rule-porter --to agents-md

There are three targets right now:

  • agents-md → AGENTS.md (splits global vs conditional, keeps globs as comments)
  • claude-md → CLAUDE.md
  • copilot → .github/copilot-instructions.md

It warns you about anything lossy. Globs get preserved as human-readable annotations, and rules that were manual-attach only in Cursor get flagged so you can decide where to put them.

I tested it against a few real repos on GitHub. It handles empty files, broken frontmatter, missing descriptions, and non-English content. Zero dependencies, runs on Node 12+.

Use --dry-run to preview without writing anything.

GitHub: GitHub - nedcodes-ok/rule-porter: Convert AI IDE rules between Cursor, Claude Code, Copilot, and AGENTS.md. Zero dependencies, runs from npx.
npm: npx rule-porter --help