job-hunter
A self-hosted, PII-safe job-search command center — for Claude Code, Codex, Cursor, and the terminal.
Job hunting buried under a hundred tabs? job-hunter scrapes job boards, tracks every application kanban-style in a local SQLite DB, fills ATS forms in shadow or auto mode, surfaces salary distributions from your own pipeline, and tailors a Reactive Resume per JD — all without ever sending your phone, ID, or session cookies to a model.
Works for any tech role — backend, frontend, mobile, data, ML, infra, devrel, security, design-eng. Drop your role keywords in profile.yaml once and the same skill works for a senior platform engineer, a junior data analyst, or a staff designer.
Webapp
Launched with job-hunter web (localhost-only, no auth):
Joblist — filter, sort, currency + period conversion
|
Tracker — kanban with drag-and-drop, tag filter
|
Detail — Claude Code commands, stage/notes, edit fields
|
Metrics — apps per day / week, by stage, by source
|
What you get
- 11 sources out of the box — LinkedIn, Indeed, Glassdoor, Gupy, RemoteOK, Job na Gringa, Remotive, We Work Remotely, Himalayas, Programathor, Coodesh. New scrapers via a
learn.py adapter that drafts YAML from any unknown form.
- Full pipeline tracking —
discovered → queued → applying → applied → screening → technical → behavioral → offer / rejected / withdrawn, with note-bearing transitions, flagging, and structured tags.
- Local FastAPI + HTMX webapp at
127.0.0.1:8765 — kanban tracker with drag-and-drop stage moves, filter by tag/source/stage/flag, sort by match/date/salary, currency conversion (BRL/USD/EUR via free ECB rates), markdown-rendered JDs, daily/weekly application charts.
- Match score per job derived from your profile + JD heuristics (seniority, country lock, on-site mismatch, US-clearance, etc.).
- Salary aggregator — p25/median/p75 from your own scraped data, no live Glassdoor scraping needed.
- AI form-fill in two modes —
shadow pauses before submit, auto requires 5 reliability gates and explicit consent.
- Resume tailoring —
/job-hunter:tailor-resume <id> emits Reactive Resume JSON tuned to the JD.
- Claude Code slash commands —
discover, apply, dig, tailor-resume, validate, web, tracker, status, review, doctor.
PII-safe by design
Your personal data (national ID, phone, address, salary expectations, session cookies) lives in ~/.config/job-hunter/secrets/personal.env — chmod 600, and the model is explicitly forbidden to read it via Read tool, cat/head/tail/grep, or any pipe whose output enters the conversation. The CLI loads it via python-dotenv in a child process; the model only ever sees field schemas. CI enforces this: lint_secret_leaks.py blocks any PR that would echo PII into logs, screenshots, or artifacts.
Install
Recommended: Claude Code plugin marketplace
/plugin marketplace add lomartins/job-hunter-skill
/plugin install job-hunter@lomartins-skills
Manual (Claude Code)
git clone [email protected]:lomartins/job-hunter-skill.git ~/.claude/skills/lomartins-job-hunter-skill
ln -s ~/.claude/skills/lomartins-job-hunter-skill/skills/job-hunter ~/.claude/skills/job-hunter
Codex CLI / Cursor / Gemini CLI
