How perryvegehan/pwp_jobhunt works
jobhunt is a personal job-search agent: it fetches public ATS postings, filters and deduplicates them, screens and ranks matches, drafts optional application materials, then builds and optionally emails a digest for human review. It also turns a resume into a reusable profile and tracks seen/applied jobs with CSV export. The CLI owns the workflow; sampled fetch, filter, LLM, storage, rendering, and mail code supports the main boundaries. Some stage wiring is documented in the README rather than fully visible in the excerpts.
Main entry points: cli.py CLI workflow · llm.py Resume profile · fetch.py ATS fetch and parse · store.py Seen and applied tracker
Components 17
CLI and profile
- CLI workflow
jobhunt/cli.py - Resume profile
jobhunt/llm.py - Profile JSON
Job discovery
- ATS fetch and parse
jobhunt/fetch.py - Mock board payloads
jobhunt/mock.py - Title/location/age gate
jobhunt/prefilter.py
Matching and drafting
- Screen and draft
jobhunt/llm.py - LLM provider clients
jobhunt/providers.py
Digest and tracking
- Seen and applied tracker
jobhunt/store.py - HTML digest
jobhunt/digest.py - Digest HTML file
- SMTP mailer
jobhunt/mailer.py - Tracker CSV
Other components
- Job seeker
- Public ATS boards
- LLM services
- SMTP service
Connections 22
- Job seeker → CLI workflow: runs commands
README.md - CLI workflow → Resume profile: builds profile
README.md - Resume profile → LLM services: extracts resume data
jobhunt/llm.py - Resume profile → Profile JSON: writes profile
README.md - CLI workflow → Profile JSON: loads profile
jobhunt/cli.py - CLI workflow → ATS fetch and parse: fetches boards
jobhunt/cli.py - ATS fetch and parse → Public ATS boards: requests postings
jobhunt/fetch.py - CLI workflow → Mock board payloads: selects mock data
jobhunt/cli.py - Mock board payloads → ATS fetch and parse: uses real parsers
jobhunt/mock.py - CLI workflow → Title/location/age gate: filters postings
jobhunt/cli.py - CLI workflow → Seen and applied tracker: deduplicates jobs
README.md - CLI workflow → Screen and draft: screens and drafts
jobhunt/cli.py - Screen and draft → LLM provider clients: requests completions
jobhunt/llm.py - LLM provider clients → LLM services: calls provider APIs
jobhunt/providers.py - CLI workflow → HTML digest: builds digest
jobhunt/cli.py - HTML digest → Digest HTML file: writes HTML
jobhunt/digest.py - CLI workflow → SMTP mailer: sends when requested
jobhunt/cli.py - SMTP mailer → SMTP service: sends email
jobhunt/mailer.py - CLI workflow → Seen and applied tracker: records results
jobhunt/cli.py - Seen and applied tracker → Tracker CSV: exports CSV
README.md - Job seeker → Digest HTML file: reviews digest
README.md - Job seeker → CLI workflow: marks applied or checks stats
README.md