Skip to content

Conversation

@kieranklaassen
Copy link
Collaborator

Summary

  • Adds cursor as a fourth target provider alongside opencode, codex, and droid
  • Enables --to cursor for both convert and install CLI commands
  • Converts Claude Code plugins into Cursor-compatible format:
    • Agents → .cursor/rules/*.mdc (Agent Requested mode, alwaysApply: false)
    • Commands → .cursor/commands/*.md (plain markdown, no frontmatter)
    • Skills → .cursor/skills/ (identical SKILL.md standard, copied directly)
    • MCP servers → .cursor/mcp.json (compatible JSON format)

Key Decisions

  • Agent Requested mode: Agents use alwaysApply: false with description set, so Cursor's AI activates rules on demand rather than flooding context with all 29 agents
  • Plain markdown commands: Cursor commands don't support YAML frontmatter — description is emitted as an HTML comment
  • Name deduplication: Flattened command names (workflows:planplan) are deduplicated if collisions occur
  • Hooks warning: Plugins with hooks emit console.warn since Cursor has no hook system

New Files

  • src/types/cursor.ts — Bundle types
  • src/converters/claude-to-cursor.ts — Converter with content transformation
  • src/targets/cursor.ts — Writer with double-nesting guard
  • tests/cursor-converter.test.ts — 20 converter tests
  • tests/cursor-writer.test.ts — 5 writer tests
  • docs/specs/cursor.md — Cursor CLI format reference

Test Plan

  • All 85 tests pass (25 new + 60 existing)
  • Converter handles: agents, commands, skills, MCP, hooks warning, edge cases
  • Writer handles: full bundle, double-nesting guard, mcp.json backup, empty bundle
  • Content transforms: .claude/.cursor/, Task calls, slash commands, @agent refs

Post-Deploy Monitoring & Validation

No additional operational monitoring required: this is a new converter target with no production runtime impact. Users opt-in via --to cursor.


Compound Engineered 🤖 Generated with Claude Code

kieranklaassen and others added 4 commits February 12, 2026 13:08
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.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@kieranklaassen kieranklaassen merged commit 0aaca5a into main Feb 12, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant