cursor2claude

cursor2claude

Translate Cursor IDE rules into a single, tidy CLAUDE.md so Claude Code understands your project.

---

✨ Why?

Cursor lets you write granular .mdc rules that keep its AI agent on‑brand. Claude Code only looks at one Markdown file – CLAUDE.md. Keeping those in sync is a chore.

cursor2claude is a tiny CLI that:

• Scans .cursor/rules//.{md,mdc} at any depth
• Categorizes rules (always‑apply • context‑specific • other)
• Decides whether to inline short / critical rules or import long ones
• Writes / updates CLAUDE.md, preserving any notes below a marker
• Offers sync, watch, and status commands for smooth DX.

Write a rule once ⇒ both AIs follow it.

---

🚀 Quick Start

One-off (no install required)

# pnpm
pnpm dlx cursor2claude sync

# npm
npx cursor2claude sync

# Yarn (≥2 / Berry)
yarn dlx cursor2claude sync

Install as a dev-dependency

# pnpm
pnpm add -D cursor2claude
pnpm cursor2claude sync

# npm
npm install --save-dev cursor2claude
npx cursor2claude sync   # or add to package.json scripts

# Yarn
yarn add -D cursor2claude
yarn cursor2claude sync

---

📋 Commands

cursor2claude sync    # One-time sync of rules to CLAUDE.md
cursor2claude watch   # Watch for changes and auto-sync
cursor2claude status  # Check current sync status

---