v0.2.1 — OSS ergonomics (docs only)

Documentation-only patch release. Fills the infrastructure gaps a small public repo needs for third-party contributors and for AI agents editing the repo.

Added

• AGENTS.md — hard rules any AI agent (Claude Code, Cursor, Codex, …) must follow when editing this repo. Dogfoods the pattern cursor-runner tells agents to read in target repos.
• CONTRIBUTING.md — dev setup, branch naming, commit conventions, the step-by-step recipe for adding a new slash command, release flow.
• SECURITY.md — vulnerability reporting via GitHub Security Advisories, the --force / --trust / --approve-mcps trade-offs, zero-deps supply-chain stance.
• GitHub templates under .github/:
  • ISSUE_TEMPLATE/bug_report.yml — structured form that asks for Node / cursor-agent / plugin version and /cursor:setup --doctor output up front.
  • ISSUE_TEMPLATE/feature_request.yml — problem-first, with a zero-deps-fit dropdown.
  • ISSUE_TEMPLATE/config.yml — blank issues disabled, upstream redirects.
  • PULL_REQUEST_TEMPLATE.md — summary + test plan + zero-deps checklist.
• README Troubleshooting section — the six failure modes hit during development (forgot /reload-plugins, zsh globbing, stale cache module-not-found, Bash permission prompt, browser MCP not loaded, no plan files) with exact fixes.

Changed

• README "Contributing" section shrunk to a pointer toward the new dedicated files. Homepage stays scannable.

No code changes

All 52 vitest specs still green, CI matrix 6/6 across Node 18.18 / 20 / 22 × Ubuntu / macOS. No behavioural changes to any slash command.

Install / upgrade

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

v0.2.0 — plan-mode bridge + zero-deps rewrite

Highlights

/cursor:from-plan — new command

Bridges Claude Code's plan mode directly into Cursor delegate. One command converts the plan file Claude drops under ~/.claude/plans/ into a task file at tasks/<timestamp>-<slug>.md and optionally hands it off to Cursor immediately.

/plan add dark-mode toggle to the settings page
# Claude proposes a plan, you approve
/cursor:from-plan --delegate --model opus
# → tasks/20260422-1945-add-dark-mode-toggle.md is created AND sent to Cursor

Zero runtime dependencies + no build step

Full rewrite from TypeScript/esbuild to plain .mjs. The source under scripts/ IS the ship artefact — /plugin install gives you a working plugin in one step, no npm install in the cache, no dist/, no bundler. Matches openai/codex-plugin-cc's shape.

What went away: execa, zod, nanoid, yargs-parser, esbuild, tsx, typescript, @types/*. What replaced them: ~200 lines of small stdlib-based helpers (lib/run.mjs, lib/id.mjs, lib/args.mjs) and plain JSON handling with JSDoc types.

Other quality fixes

• Robust entry-point detection (lib/invoked.mjs) — realpathSync on both sides, fixes a silent no-op when the plugin was executed through a symlinked path (e.g. macOS /tmp → /private/tmp).
• All slash-command bodies now "$ARGUMENTS" quoted to prevent zsh from globbing ?, * inside prompts.
• /cursor:browser post-flight recursively walks tool_use blocks nested in assistant.message.content[] — no more false-positive "MCP never called" when Cursor did use it.

Full changelog

See CHANGELOG.md.

Install

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

Zero build, zero npm install needed after /plugin install.

Commands (9 total)

• /cursor:delegate — hand a coding task to Cursor
• /cursor:from-plan — new — plan file → task file → delegate
• /cursor:browser — real-browser verification via chrome-devtools MCP
• /cursor:status / /cursor:result / /cursor:cancel / /cursor:resume / /cursor:sessions
• /cursor:setup — health-check + configured MCPs

Plus cursor-runner subagent.