JobHuntAgent

Job Hunt Agent

A Claude Code agent for job hunting: tailors a one-page resume to each job description, scores fit, scrapes postings from job boards, drafts recruiter emails, and tracks everything on a dashboard.

Run it inside **Claude Code**. On first use the agent interviews you once to build a reusable "base template" from your real experience. After that, paste a job description and get a tailored, ATS-checked one-page PDF back.

---

What you get

• A locked one-page HTML/PDF resume template (templates/resume_base.html). Layout and CSS never change; only the content does.
• A bullet-library + per-job-spec model (scripts/build_resume.py, scripts/resume_specs.py). Tailoring = selecting, ordering and rephrasing your real bullets toward a JD's own words. Nothing fabricated.
• A mechanical QA gate (scripts/verify_resume.py): fails a resume for more than one page, em/en dashes, too few bullets, too thin, banned filler, an unheld job-title claim, unverified [estimate] markers, non-ATS-parseable layout, or ligature glyphs that break literal keyword matching.
• A one-page PDF compiler with auto-fit (scripts/compile_pdf.py).
• An onboarding interview (ONBOARDING.md) the agent runs to set this up from your existing resume, then asks about salary, roles and locations.
• API-key setup guides (docs/01_SETUP_API_KEYS.md) for the optional Telegram digest, Gmail drafts, and a Supabase + Vercel approval dashboard.

---

Quick start

1. Install prerequisites:

   • Python 3.10+
   • Google Chrome (used to render the PDF)

   pip install -r requirements.txt

2. Copy the config templates:

   cp config/profile.example.json config/profile.json
   cp config/resume_rules.example.json config/resume_rules.json

3. Open this folder in Claude Code and say:

   **"Set up my base resume."**

   The agent follows `ONBOARDING.md`: asks for your current resume (or interviews you from scratch