Skip to content

cursor.md

Latest commit

 

History

History
116 lines (83 loc) · 3.42 KB

cursor.md

File metadata and controls

116 lines (83 loc) · 3.42 KB
Raw

Install — Cursor
Validated against Cursor 3.14.7
Minimum supported 3.14.7
Plugin manifest .cursor-plugin/plugin.json
Marketplace manifest none — Cursor imports the plugin manifest from the repo
Official docs Plugins · Rules

Check your version: Cursor → About Cursor, or cursor --version.

Cursor's docs state no minimum version for plugins. The floor above is the version this release was actually validated on rather than a guess — older builds may work.

The previous floor in this repo was 0.45.0, which predates Cursor's plugin system entirely. It was never a real constraint.

Prerequisites

  • Cursor 3.14.7 or newer
  • Node.js ≥ 18 on your PATH

Option A — Import from repo (no clone)

Cursor reads .cursor-plugin/plugin.json directly out of a GitHub repo:

  1. Dashboard → Plugins → Team Marketplaces → Add Marketplace
  2. Choose Import from Repo and enter TamirCohen28/headhunter
  3. Install headhunter and reload Cursor

Leave Auto Refresh on: Cursor re-reads the whole manifest on every push, so a version bump is not required for you to pick up changes — unlike Claude Code.

Option B — Open the repo (rules + MCP, no plugin install)

Clone and open the repo root in Cursor. Two things activate immediately with no install step:

  • Rules — .cursor/rules/headhunter.mdc auto-loads
  • MCP — .cursor/mcp.json registers the Notion server
git clone https://github.com/TamirCohen28/headhunter.git
cd headhunter
cursor .

This is the fastest path if you mainly want the CRM scripts plus HeadHunter context in chat, and don't need the plugin packaging.

Option C — Local plugin (development)

git clone https://github.com/TamirCohen28/headhunter.git
cd headhunter
make install

Then reload Cursor — Command Palette → Developer: Reload Window.

What you get

Component Cursor
16 skills ✅
14 subagents ✅
Slash commands ✅
.cursor/rules/headhunter.mdc ✅ auto-loaded
Notion MCP (.cursor/mcp.json) ✅
hooks/hooks.json ❌ Claude Code and Codex only

Integrations (all optional)

cp .env.example .env
node scripts/check-mcp-env.js   # reports what's wired and what's missing

Notion, Google Calendar/Tasks, Todoist, Twilio, and LinkedIn are each opt-in.

Verify

Settings → Tools & MCP — confirm notion is enabled (green), if you set NOTION_TOKEN. Then in chat:

/headhunter:dashboard

Or host-independently:

node scripts/crud.js seed
node scripts/dashboard.js

Update

git pull && make update

With Auto Refresh on, a marketplace-imported plugin updates itself on push. Reload the window after either.

Troubleshooting

Symptom Fix
Rules not applying Confirm .cursor/rules/headhunter.mdc exists and you opened the repo root, not a subdirectory.
MCP server red in Settings NOTION_TOKEN unset, or node not on PATH. Run node scripts/check-mcp-env.js.
Plugin not appearing after import Reload the window; confirm the repo is public and the manifest is on the default branch.
Hooks don't fire Expected — Cursor has no hooks.json equivalent.

More: troubleshooting.md.