Skip to content

claude-code.md

Latest commit

 

History

History
137 lines (97 loc) · 3.97 KB

claude-code.md

File metadata and controls

137 lines (97 loc) · 3.97 KB
Raw

Install — Claude Code
Validated against Claude Code 2.1.220
Minimum supported 2.0.0
Plugin manifest .claude-plugin/plugin.json
Marketplace manifest .claude-plugin/marketplace.json
Official docs Plugins reference · Marketplaces · Skills

Check your version:

claude --version

Prerequisites

  • Claude Code 2.0.0 or newer (2.1.220 is what this release was validated on)
  • Node.js ≥ 18 — node --version
  • No npm install: the CRM scripts use Node's standard library only

Method A — standalone, straight from GitHub

No clone, no catalog. This repo carries its own .claude-plugin/marketplace.json alongside the plugin manifest, so Claude Code installs it directly:

/plugin marketplace add TamirCohen28/headhunter
/plugin install headhunter@headhunter
/reload-plugins

To pick up a new release later:

/plugin marketplace update headhunter
/plugin update headhunter@headhunter

Claude Code caches installed plugins by the version field in plugin.json. If a release did not bump the version, /plugin update is a no-op.

Method B — via the tamirs-plugins catalog

If you already use the other plugins in that family:

/plugin marketplace add Tamircohen28/plugins
/plugin install headhunter@tamirs-plugins
/reload-plugins

Method C — from a local clone (development)

git clone https://github.com/TamirCohen28/headhunter.git
cd headhunter
make install    # verifies Node >= 18 and prints per-platform steps

Then, from an interactive claude session:

/plugin marketplace add /path/to/headhunter
/plugin install headhunter@headhunter

What you get

  • 16 skills under skills/ — always loaded
  • 14 subagents under agents/ — dispatched by the skills
  • Slash commands under commands/ — /headhunter:discover, /headhunter:apply, …
  • Hooks from hooks/hooks.json — session briefing and MCP wiring
  • Notion MCP server from .mcp.json, when NOTION_TOKEN is set

Integrations (all optional)

Copy .env.example to .env and fill in only what you use:

cp .env.example .env

HeadHunter works fully with none of them set — Notion, Google Calendar/Tasks, Todoist, Twilio, and LinkedIn are each opt-in. Verify what's wired:

node scripts/check-mcp-env.js

Data location

CRM data is local JSON under data/ (gitignored). To share one pipeline across hosts:

export HEADHUNTER_DATA_DIR="$HOME/.headhunter/data"

Restart Claude Code after changing env vars.

Verify

/headhunter:dashboard
/headhunter:discover

Or without any host at all:

node scripts/crud.js seed     # 5 demo applications
node scripts/dashboard.js

MCP tools appear as mcp__plugin_headhunter_notion__<tool>.

Update

/plugin marketplace update headhunter
/plugin update headhunter@headhunter

Or git pull && make update for a clone. Restart Claude Code either way.

Troubleshooting

Symptom Fix
Marketplace file not found You're on a revision older than 1.5.0, before .claude-plugin/marketplace.json was added. Update the clone, or use the catalog (Method B).
/plugin update does nothing The release didn't bump plugin.json version. Check the releases page.
Skills don't appear after install /reload-plugins, then restart Claude Code. /reload-plugins does not re-fetch from GitHub — it only reloads what's cached.
Notion tools missing NOTION_TOKEN is unset. node scripts/check-mcp-env.js reports what's missing.
Commands run but find no data HEADHUNTER_DATA_DIR points somewhere empty, or you never seeded. Run node scripts/crud.js seed.

More: troubleshooting.md.