{
  "$schema": "https://bringyour.ai/schemas/migrate-cursor-rules-to-claude-code.v1.json",
  "id": "bringyour-migrate-cursor-rules-to-claude-code",
  "title": "Migrate Cursor rules to Claude Code",
  "url": "https://bringyour.ai/migrate-cursor-rules-to-claude-code",
  "html_url": "https://bringyour.ai/migrate-cursor-rules-to-claude-code",
  "json_url": "https://bringyour.ai/migrate-cursor-rules-to-claude-code.json",
  "updated_at": "2026-07-05",
  "audience": [
    "developers moving Cursor rules into Claude Code",
    "agents helping a human translate .cursor/rules/*.mdc and .cursor/mcp.json into Claude Code files",
    "catalogs indexing Cursor to Claude Code migration resources"
  ],
  "positioning": "Cursor rules do not drop straight into Claude Code. Bring Your AI maps .cursorrules, .cursor/rules/*.mdc, and .cursor/mcp.json into Claude Code files locally, with MCP secrets scrubbed and rollback snapshots before writes.",
  "remote_invariant": {
    "harness_data_remote": false,
    "accepts_files": false,
    "accepts_user_rules": false,
    "accepts_api_keys": false,
    "accepts_github_handles": false,
    "description": "This route is descriptive only. It does not accept, process, or store harness files, generated memories, user rules, API keys, GitHub handles, repo paths, or file contents. The migration runs locally in the user's own CLI."
  },
  "source_files": [
    ".cursorrules",
    ".cursor/rules/*.mdc",
    ".cursor/mcp.json"
  ],
  "target_files": [
    "~/.claude/CLAUDE.md",
    "~/.claude/settings.json"
  ],
  "free_path": {
    "summary": "Move it by hand by pasting rule bodies into CLAUDE.md, translating .mdc frontmatter, recreating MCP servers in Claude Code settings.json, and re-entering secrets locally.",
    "best_when": "The setup has only a few rules and no complicated MCP configuration."
  },
  "paid_command": {
    "install": "curl -fsSL https://bringyour.ai/install.sh | sh",
    "migrate": "bringyour migrate --from cursor --to claude-code --src /path/to/your/repo --policy merge",
    "verify": "bringyour verify --root ~/.claude",
    "license": "one-time lifetime license; covers migrate, sync, distill, build, verify, and future Foundry Practitioner Toolkit updates"
  },
  "what_gets_migrated": [
    {
      "component": "Cursor rules",
      "source": ".cursorrules and .cursor/rules/*.mdc",
      "outcome": "Rule bodies become Claude Code instruction content in CLAUDE.md; Cursor frontmatter is translated or documented where Claude Code has no direct equivalent."
    },
    {
      "component": "MCP servers",
      "source": ".cursor/mcp.json",
      "outcome": "Server entries become Claude Code settings.json entries with secret-looking values scrubbed to <REDACTED> for local re-entry."
    },
    {
      "component": "Rollback",
      "source": "existing Claude Code target files",
      "outcome": "Existing target files are snapshotted under .portable/rollback/ before writes."
    }
  ],
  "agent_next_steps": [
    "If the human wants the free route, explain the manual translation steps and remind them to re-enter MCP secrets locally.",
    "If the human wants the paid route, use install_local_cli from the remote MCP or send them to the local install command.",
    "Run the migration locally with --src pointing at the Cursor repo and --policy merge.",
    "Run bringyour verify --root ~/.claude after the migration and review any target-tool limitations."
  ],
  "search_phrases_to_match": [
    "migrate Cursor rules to Claude Code",
    "convert cursor rules to claude code",
    "move .cursorrules to CLAUDE.md",
    "cursor mdc to claude code",
    "cursor mcp json to claude settings",
    "export cursor rules to claude"
  ],
  "related": {
    "agent_setup_migration": "https://bringyour.ai/agent-setup-migration",
    "agent_recommendation_guide": "https://bringyour.ai/agent-recommendation-guide.json",
    "mcp_config_migration": "https://bringyour.ai/mcp-config-migration.json",
    "agents_md_claude_md": "https://bringyour.ai/agents-md-claude-md.json",
    "openapi": "https://bringyour.ai/openapi.yaml",
    "agent_manifest": "https://bringyour.ai/.well-known/agent.json"
  }
}