Repository avatar
Other Tools
v0.12.0
active

jobwatch

io.github.vinayvobbili/jobwatch

Watch company job boards, rank new matches and track every application. Never auto-applies.

Documentation

jobwatch

CI PyPI Home page

Watch the job boards of the companies you care about and get a short, ranked digest of new roles that match you, optionally fit-scored against your resume. jobwatch finds and ranks. It never applies for you.

jobwatch: watch boards, rank by fit, ask about your jobs, track applications, prep for interviews

With sound (1½ minutes, made from made-up data):

https://github.com/user-attachments/assets/71b048d0-d372-42fd-a247-c4a59c3ffd71

Get started

Install uv, which brings Python with it, then jobwatch:

curl -LsSf https://astral.sh/uv/install.sh | sh      # Mac or Linux (or: brew install uv)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"      # Windows (or: winget install astral-sh.uv)

uv tool install jobwatch
jobwatch ui

Already have Python? pipx install jobwatch works too.

A page opens on your computer and walks you through four short steps: about you and your resume, the jobs you want, the companies to watch, and (optionally) fit scores and job-alert emails. Then press Check for new jobs. Install the page as an app from Chrome's address bar to keep it in its own window, or run jobwatch service install to have it always running, on macOS, Linux or Windows (a launchd agent, a systemd user unit or a Task Scheduler task).

Or run it from Claude:

  • Claude Code (the Claude app's Code tab, the terminal, and Cowork): /plugin marketplace add vinayvobbili/jobwatch, then /plugin install jobwatch@jobwatch (or Settings → Plugins → Add marketplace). The plugin brings the tools and a skill with the daily routine, and runs jobwatch with uv. Then ask Claude "watch Stripe for product designer roles".
  • Claude Desktop with Settings → Extensions: download the extension (jobwatch.mcpb, always the latest release), open it and press Install. Claude Desktop sets up everything it needs, uv included.

A chat on claude.ai, or in an app whose plugins run in the cloud, can't reach jobwatch on your computer.

Extras: jobwatch[score] (fit scores with the Claude API), jobwatch[local] (fit scores with a local model on any OpenAI-compatible server, LOCAL_LLM_URL if it isn't at http://127.0.0.1:8010/v1), jobwatch[mcp] (an MCP server), jobwatch[video] (drill videos) and jobwatch[lca] (H-1B wage filings as a second pay source). Prefer a terminal? jobwatch init, jobwatch find "Globex", then jobwatch run daily. More on the page and the command line →

Example

All of this is made-up data. A digest entry (the same text jobwatch run prints and get_digest returns):

# jobwatch digest

Top 2 of 9 matching job(s). Filtered out: 14 by location, 31 by title.
Scored 2 with shortlist-ai.

### [Senior Platform Engineer](https://jobs.ashbyhq.com/initech/7f3a1c)
Initech; Remote (US) · $180K–$220K · posted 1d ago
**Fit 78/100**, must-haves 4/6 (scored by Qwen3.5-9B · local). Gaps: Observability (metrics, tracing); Led an on-call rotation
Source: Initech's Ashby board
`ashby:initech:7f3a1c`

The card behind that score, from jobwatch show ashby:initech:7f3a1c, with the resume's own words per verdict:

Fit 78/100, must-haves 4/6 (scored by Qwen3.5-9B · local)
  met     [must] 5+ years running Kubernetes in production  "Ran 40-node Kubernetes clusters for 6 years at Globex"
  met     [must] Terraform or similar infrastructure as code  "Wrote the Terraform modules behind 120 services"
  met     [must] Python for tooling and automation  "Python: CLI tools, CI pipelines, internal APIs"
  partly  [must] Observability (metrics, tracing)  "Set up Prometheus dashboards for the payments team"
  met     [must] Incident response  "Cut mean time to recover from 90 to 25 minutes"
  missing [must] Led an on-call rotation
  met     [nice] Postgres operations  "Tuned Postgres replicas serving 5K queries per second"

Why trust it

  • About 2,400 tests in 121 modules, none of which touch the network (a fixture fails any test that tries).
  • CI runs ruff and the whole suite on Python 3.10 and 3.13 for every push; the same checks run before every push.
  • Fit scoring was checked on a small eval of 29 expected verdicts. The suggested 16 GB model (Qwen3.5-9B, 4-bit) agreed on 28, a 6-bit build on 27 and Gemma 4 12B on 29, at 27, 36 and 42 seconds a call: within noise. Only the 16 GB row of the model table was tested. Fit scores

Design in 5 lines

  1. Poll each company's public board or API once per run, follow robots.txt, back off when asked.
  2. Keep only new roles that pass your title, place and pay filters, ranked by keyword relevance.
  3. Fit-score only the top few per digest (scoring.top, 5 in the example watchlist): your resume against the posting's must-haves and nice-to-haves.
  4. Quote-verify: each verdict carries the resume's own words, checked against the resume text.
  5. A job is scored once, and the score says which model made it, so a new model or an edited resume never triggers a surprise bill.

Limits

  • It reads the boards in the table below. A company on any other system isn't watched; add its jobs through job-alert emails, a link or pasted text. It doesn't scrape LinkedIn or Indeed.
  • It finds and ranks. It never applies; you answer the forms and press Submit.
  • Fit scores are an LLM's judgment, checked against your resume's text, not against how a recruiter reads it. The eval is small (29 verdicts, one model row).
  • The always-on service (jobwatch service install) covers macOS (launchd), Linux (a systemd user unit) and Windows (Task Scheduler). Linux needs systemd; elsewhere run jobwatch ui when you want the page.

What it does

Watches company boardsGreenhouse, Lever, Ashby, Workable, Workday, Eightfold, Oracle, SmartRecruiters, Rippling, iCIMS, Jobvite, Comeet, Gem, Recruitee, Avature, Google, Amazon, careers sites with a job sitemap, HN's Who is hiring and VC portfolio job boards (one board, hundreds of companies). Fresh roles, real pay ranges, robots.txt respected. Why boards · the watchlist
Scores fitYour resume against each posting: must-haves met, gaps, a score out of 100. On the Claude API, Antigravity, or this Mac. Fit scores
Keeps a short queueToday's picks, a queue to apply from, job-alert emails and status emails read for you, reposts caught. Applying
Tailors a resume per jobWith resume-kit installed, one button on a queued job builds a resume from your confirmed facts and keeps it with the application for Apply and the extension to attach. Tailoring
Tracks applicationsEvery stage, the next step, follow-ups for the ones gone quiet, a calendar feed. Tracking
Preps interviewsA prep sheet per interview, answers drafted from your own stories, a mock interview, a drill video. Interview prep
Compares offersPay, career value and company health side by side. Comps
Shows who you knowYour LinkedIn connections at each company, the people you actually talk to first. Who you know
Answers questionsA chat about today's jobs and each posting, and the skills your matches keep asking for. Chat · Skills
Works with assistantsAn MCP server and an agent skill, so Claude can run your search with you. MCP server

Everything stays on your computer, except what a model you choose for fit scores and chat receives: the Claude API or Antigravity get the posting and your resume (and your stories, for drafted answers). On-device models send nothing.

Tutorials

Seven videos of two minutes or less, made from made-up data. If one stops after a second or two (GitHub's video links last five minutes), reload the page.

Why it doesn't auto-apply

Tools that auto-apply to hundreds of jobs make the process worse for everyone and rarely work:

  • Recruiters recognize mass applications.
  • Some companies cap how many roles one person can apply to.
  • Application forms ask legal questions (work authorization, export control, signatures) that you answer yourself.

jobwatch makes sure you never miss a role worth applying to, and spends your time on those. Getting more interviews has what moves an application from the pile to a recruiter's call.

The guide

Everything else, from every watchlist setting to the drill video, is in the guide. Development covers running the tests and making a release. MIT licensed.

If jobwatch helps your search, a ⭐ on GitHub is how I know: jobwatch has no usage tracking, so stars are the only count of who uses it. If it landed you an interview, a $1 coffee says so too.

Listed on: M8ven · Glama · mcpservers.org · AI Agents Listing · Agensi

PYPI
jobwatch
Install Command
pip install jobwatch
Runtime: uvx