cursor-plugin-cc

Claude plans. Cursor writes. Claude reviews. A Claude Code plugin that delegates coding execution to Cursor's Composer — without ever leaving the Claude Code TUI.

Plan. Delegate. Ship.

you ▸ /plan add a /health endpoint to our Express app that returns { status, version, uptime }

claude ▸ Plan written to ~/.claude/plans/health-endpoint.md
         (4 acceptance criteria, 3 files to touch, verify with `npm test`)

you ▸ /cursor:from-plan --delegate

plugin ▸ wrote tasks/20260427-1830-health-endpoint.md
       ▸ handing off to cursor-agent (composer-2.5-fast, --force)…

cursor ▸ ✓ src/routes/health.ts          (new, 24 lines)
       ▸ ✓ src/app.ts                    (mounted route)
       ▸ ✓ tests/health.test.ts          (new, 3 passing)
       ▸ done in 11s · chat_id=V1StGXR8_Z

you ▸ review the diff

claude ▸ LGTM. Nit: hard-coded "1.0.0" — pull from package.json instead.

you ▸ /cursor:resume "read version from package.json"

cursor ▸ ✓ src/routes/health.ts          (1 line changed)
       ▸ ✓ tests/health.test.ts          (assertion updated, still passing)
       ▸ done in 4s

That's the whole loop. Claude does the thinking (plan, review). Cursor does the typing (file edits, tests). You stay in one TUI.

Why this is fast: composer-2.5-fast is Cursor's tuned-for-CLI variant — it ships small, well-scoped changes in seconds. Claude Code spends its tokens on planning and reviewing, where thinking actually matters. Two tools, each doing what they're best at.

Install

Preferred — from GitHub:

/plugin marketplace add freema/cursor-plugin-cc
/plugin install cursor@tomas-cursor
/reload-plugins
/cursor:setup

Local, for hacking on the plugin from a checkout:

/plugin marketplace add /Users/you/path/to/cursor-plugin-cc
/plugin install cursor@tomas-cursor
/reload-plugins
/cursor:setup

⚠️ Do not skip /reload-plugins. Right after /plugin install the /cursor:* commands are NOT yet available — Claude Code only picks them up after a plugin reload. If you see Unknown command: /cursor:setup, you forgot this step — run /reload-plugins and try again.

The plugin ships as plain ESM JavaScript with zero runtime dependencies — just the Node stdlib. /plugin install is literally all you need; no npm install, no build step, no dist/ folder. Each slash command runs node "${CLAUDE_PLUGIN_ROOT}/scripts/<cmd>.mjs" directly from the committed source.

The first /cursor:setup run tells you if cursor-agent is missing or unauthenticated. For hacking on the plugin itself (tests, lint, formatting), see Contributing below.

Requirements

• Node.js ≥ 18.18
• A Cursor account — paid for Composer models; free works with --model auto or other entitled models
• cursor-agent on your PATH — install via curl https://cursor.com/install -fsS | bash
• cursor-agent login completed at least once

The flow — three commands, end to end

This is the entire happy path. Three commands inside Claude Code: