YourAITools

Cursor Rules Converter: .mdc to AGENTS.md, CLAUDE.md, Copilot, Devin, Gemini

Keep your Cursor rules when you add Claude Code, Codex, Copilot, Devin or Gemini CLI: one command converts them all.

Cursor Rules Converter: .mdc to AGENTS.md, CLAUDE.md, Copilot, Devin, Gemini product illustration

What it does

Turn your Cursor project rules into the files every other coding agent reads, keeping their scope: a rule that only applies to app//*.tsx in Cursor stays scoped to app//*.tsx in Claude Code, Copilot and Devin/Windsurf.

One Python file, standard library only (Python 3.9+). Nothing is uploaded anywhere.

What you get

The screenshot is real output from the kit’s own commands. Tested from a fresh download of this exact zip: ./run_tests.sh ran 18 tests OK on Python 3.13 and 3.10.

Real terminal output from Cursor Rules Converter: .mdc to AGENTS.md, CLAUDE.md, Copilot, Devin, Gemini: demo and passing tests

Run it

./tools/demo.sh                                                      # sample project with all 4 rule kinds
python3 tools/convert_rules.py /path/to/project                      # dry run: shows rules and planned files
python3 tools/convert_rules.py /path/to/project --write              # write every format into the project
python3 tools/convert_rules.py /path/to/project --to claude,copilot --write
python3 tools/convert_rules.py /path/to/project --check app/page.tsx # which rules load for a file

Existing files are never overwritten unless you add --force. --out DIR writes somewhere else.

How each Cursor rule kind is converted

Cursor ruleAGENTS.md / GEMINI.mdClaude CodeGitHub CopilotDevin Local / Windsurf
alwaysApply: true (and .cursorrules)top section.claude/rules/<name>.md, no frontmatter (always loaded).github/copilot-instructions.mdtrigger: always_on
globs: (auto attached)"When working on files matching ..." section.claude/rules/<name>.md with paths: list.github/instructions/<name>.instructions.md with applyTotrigger: glob + globs
description: only (agent requested)"When: ..." section.claude/skills/<name>/SKILL.md (loaded when relevant).instructions.md with description (VS Code Local sessions load it by task relevance)trigger: model_decision
none (manual, @rule)"Only when the user asks" sectionskill with disable-model-invocation: true (you run /name).instructions.md to attach by handtrigger: manual

Globs in either Cursor form (comma string or YAML list) are supported. Rules in subfolders (.cursor/rules/frontend/x.mdc) become frontend-x. --windsurf writes the legacy .windsurf/rules/ folder (Devin Local still imports it) instead of .devin/rules/.

Warnings it gives you

  • AGENTS.md / GEMINI.md over 32 KiB (Codex stops reading project docs at 32 KiB combined by default) or over 300 lines.
  • Scoped rules flattened into a single file (AGENTS.md has no globs; use nested AGENTS.md files if that matters).
  • Rule bodies over ~12,000 characters, and @file references that only Claude Code resolves.

Files

  • tools/convert_rules.py the converter; tools/demo.sh the demo
  • examples/sample-project/ five rules covering every kind
  • skills/convert-cursor-rules/ lets Claude Code run it for you (claude --plugin-dir ./cursor-rules-converter)
  • tests/ 18 tests (parsing, glob matching, every target, scope round-trip, no-overwrite)

Honest limits

  • Formats were checked against the Cursor, Claude Code, GitHub Copilot / VS Code, Devin and Gemini CLI docs in November 2026; tools change, so re-check if a file is not picked up.
  • Glob matching in --check approximates each tool's matcher for common patterns (, *, ?, {a,b}); exotic patterns may differ.
  • Rules guide models; they do not enforce anything. Not affiliated with Cursor, Anthropic, GitHub, Cognition or Google.

Format and license

Zip, 15 KB, v1.0, 19 files. Free to use, modify and share for any purpose, including commercial work, as long as this notice stays in copies. Not affiliated with Cursor, Anthropic, GitHub, Cognition or Google.

FAQ

Does it change my Cursor rules?
No. It only reads them and writes new files, and never overwrites without --force.
What about Windsurf?
Windsurf is now Devin Local; --windsurf writes the legacy .windsurf/rules folder, which is still imported.
Is it really free?
Yes, the whole tool. The paid rules packs are optional.
How do I get the files?
Click Download free. The zip downloads straight away: no checkout, no account.
Do I have to sign up for the newsletter?
No. The form is optional and the download works without it.

Get Cursor Rules Converter: .mdc to AGENTS.md, CLAUDE.md, Copilot, Devin, Gemini

Free tool: convert Cursor .mdc rules and .cursorrules to AGENTS.md, Claude Code rules, Copilot instructions, Devin/Windsurf rules and GEMINI.md, keeping globs.

Free free download

Download free (zip)Or get Cursor Rules All-Stacks Bundle →

Pairs well with

Related

1 email a week: new x402 + MCP tools and free kits.

Short weekly digest of new x402 + MCP tools and free kits, including the MCP OAuth Checker. The download above works without signing up. No spam, unsubscribe any time.