Skip to main content

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 jobwatch-<version>.mcpb from 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 boards Greenhouse, 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 fit Your 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 queue Today's picks, a queue to apply from, job-alert emails and status emails read for you, reposts caught. Applying
Tailors a resume per job With 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 applications Every stage, the next step, follow-ups for the ones gone quiet, a calendar feed. Tracking
Preps interviews A prep sheet per interview, answers drafted from your own stories, a mock interview, a drill video. Interview prep
Compares offers Pay, career value and company health side by side. Comps
Shows who you know Your LinkedIn connections at each company, the people you actually talk to first. Who you know
Answers questions A chat about today's jobs and each posting, and the skills your matches keep asking for. Chat · Skills
Works with assistants An 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 sends nothing home, 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

Metadata

Release files for jobwatch 0.12.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jobwatch 0.12.0
File Size Uploaded Provenance Actions
jobwatch-0.12.0.tar.gz 2.0 MB With provenance Details for jobwatch-0.12.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for jobwatch 0.12.0
File Interpreter ABI Platform Actions
jobwatch-0.12.0-py3-none-any.whl Python 3 none any Details for jobwatch-0.12.0-py3-none-any.whl

Total release size: 2.9 MB

Release files / jobwatch-0.12.0.tar.gz

Download URL jobwatch-0.12.0.tar.gz
Size 2.0 MB
Tags Source
SHA-256 checksum
How to use checksums
71d67e60524b1e48c1888b1c1de422eafe760a8b9ae24f79ae131e72699dad68
BLAKE2b-256 checksum
How to use checksums
8f77162675b4049e89bf85b342a80685d597fdfe490c888cd7424966baf4c04d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Release files / jobwatch-0.12.0-py3-none-any.whl

Download URL jobwatch-0.12.0-py3-none-any.whl
Size 869.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
052a09c3428b83011a757a8588b856d79d0083a2a70be4d57c42265521945672
BLAKE2b-256 checksum
How to use checksums
ec5091bd07520e08574dee617ce21dec07d97a080c9b3508828af841f444b2b6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

Security for jobwatch 0.12.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for jobwatch-0.12.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 16, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page