Add Cursor CLI as target provider (#179)

* feat(cursor): add Cursor CLI as target provider

Add converter, writer, types, and tests for converting Claude Code
plugins to Cursor-compatible format (.mdc rules, commands, skills,
mcp.json). Agents become Agent Requested rules (alwaysApply: false),
commands are plain markdown, skills copy directly, MCP is 1:1 JSON.

* docs: add Cursor spec and update README with cursor target

* chore: bump CLI version to 0.5.0 for cursor target

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: note Cursor IDE + CLI compatibility in README

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

src/targets/cursor.ts

@@ -0,0 +1,48 @@
+import path from "path"
+import { backupFile, copyDir, ensureDir, writeJson, writeText } from "../utils/files"
+import type { CursorBundle } from "../types/cursor"
+
+export async function writeCursorBundle(outputRoot: string, bundle: CursorBundle): Promise<void> {
+  const paths = resolveCursorPaths(outputRoot)
+  await ensureDir(paths.cursorDir)
+
+  if (bundle.rules.length > 0) {
+    const rulesDir = path.join(paths.cursorDir, "rules")
+    for (const rule of bundle.rules) {
+      await writeText(path.join(rulesDir, `${rule.name}.mdc`), rule.content + "\n")
+    }
+  }
+
+  if (bundle.commands.length > 0) {
+    const commandsDir = path.join(paths.cursorDir, "commands")
+    for (const command of bundle.commands) {
+      await writeText(path.join(commandsDir, `${command.name}.md`), command.content + "\n")
+    }
+  }
+
+  if (bundle.skillDirs.length > 0) {
+    const skillsDir = path.join(paths.cursorDir, "skills")
+    for (const skill of bundle.skillDirs) {
+      await copyDir(skill.sourceDir, path.join(skillsDir, skill.name))
+    }
+  }
+
+  if (bundle.mcpServers && Object.keys(bundle.mcpServers).length > 0) {
+    const mcpPath = path.join(paths.cursorDir, "mcp.json")
+    const backupPath = await backupFile(mcpPath)
+    if (backupPath) {
+      console.log(`Backed up existing mcp.json to ${backupPath}`)
+    }
+    await writeJson(mcpPath, { mcpServers: bundle.mcpServers })
+  }
+}
+
+function resolveCursorPaths(outputRoot: string) {
+  const base = path.basename(outputRoot)
+  // If already pointing at .cursor, write directly into it
+  if (base === ".cursor") {
+    return { cursorDir: outputRoot }
+  }
+  // Otherwise nest under .cursor
+  return { cursorDir: path.join(outputRoot, ".cursor") }
+}

src/targets/index.ts

@@ -2,12 +2,15 @@ import type { ClaudePlugin } from "../types/claude"
 import type { OpenCodeBundle } from "../types/opencode"
 import type { CodexBundle } from "../types/codex"
 import type { DroidBundle } from "../types/droid"
+import type { CursorBundle } from "../types/cursor"
 import { convertClaudeToOpenCode, type ClaudeToOpenCodeOptions } from "../converters/claude-to-opencode"
 import { convertClaudeToCodex } from "../converters/claude-to-codex"
 import { convertClaudeToDroid } from "../converters/claude-to-droid"
+import { convertClaudeToCursor } from "../converters/claude-to-cursor"
 import { writeOpenCodeBundle } from "./opencode"
 import { writeCodexBundle } from "./codex"
 import { writeDroidBundle } from "./droid"
+import { writeCursorBundle } from "./cursor"
 
 export type TargetHandler<TBundle = unknown> = {
   name: string
@@ -35,4 +38,10 @@ export const targets: Record<string, TargetHandler> = {
     convert: convertClaudeToDroid as TargetHandler<DroidBundle>["convert"],
     write: writeDroidBundle as TargetHandler<DroidBundle>["write"],
   },
+  cursor: {
+    name: "cursor",
+    implemented: true,
+    convert: convertClaudeToCursor as TargetHandler<CursorBundle>["convert"],
+    write: writeCursorBundle as TargetHandler<CursorBundle>["write"],
+  },
 }