jobwatch
# jobwatch
<!-- mcp-name: io.github.vinayvobbili/jobwatch -->
[Home page](https://vinayvobbili.github.io/jobwatch/)
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.

With sound (1½ minutes, made from made-up data):
https://github.com/user-attachments/assets/71b048d0-d372-42fd-a247-c4a59c3ffd71
## Tutorials
Seven short videos, two minutes or less each, made from made-up data. GitHub's video links last five minutes,
so if one stops after a second or two, reload the page and play it again.
**Getting started**: install, `jobwatch`, the four onboarding steps, Today.
https://github.com/user-attachments/assets/f95f85df-406f-4ede-b84c-59569d1a586a
**Your daily routine**: today's picks, a job's details, the queue, "I applied", Applications, the prep sheet.
https://github.com/user-attachments/assets/8653c4ca-a79d-4135-9be1-51ba3c9fccf6
**Where the AI runs**: the Claude API, Antigravity or this Mac; the fallback chain; what leaves your computer.
https://github.com/user-attachments/assets/40e6f2cb-c201-4da9-ba21-77bdacc464b8
**Applying**: the queue, jobs found elsewhere, job-alert emails, status emails, companies to watch.
https://github.com/user-attachments/assets/9d021676-85da-4ce1-8d42-f3808b4ae03b
**Tracking applications**: stages and follow-ups, applications that go quiet, the calendar feed, Interviews.
https://github.com/user-attachments/assets/e2e43a54-83d2-4154-9229-a063fafefe44
**Interview prep**: prep sheets, answers drafted from your stories, a mock interview, a drill video.
https://github.com/user-attachments/assets/c8ac1030-700f-4cdd-823d-4b92cd411bf3
**Comps and who you know**: pay, career value and company health side by side; the people you know there.
https://github.com/user-attachments/assets/42eb0edb-945e-4caf-95c0-3eeae6fdada6
## Get started
```
curl -LsSf https://astral.sh/uv/install.sh | sh # installs uv (other systems: brew install uv, or the docs below)
uv tool install jobwatch
```
Then run `jobwatch`. uv brings Python with it; install options for every system:
https://docs.astral.sh/uv/getting-started/installation/
Already have Python? This works too:
```
pipx install jobwatch # or: pip install jobwatch
```
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 a Mac, Linux or Windows).
**Or run it from Claude:**
- **Claude Code** (the Claude app's Code tab, the terminal, and Cowork): add the marketplace
`vinayvobbili/jobwatch` (Settings → Plugins → Add → Add marketplace, or `/plugin marketplace add
vinayvobbili/jobwatch`), then install **jobwatch** (`/plugin install jobwatch@jobwatch`). The
[plugin](plugin/README.md) brings the tools and a skill with the daily routine; it runs jobwatch with
[uv](https://docs.astral.sh/uv/). Then ask Claude "watch Stripe for product designer roles".
- **Claude Desktop with Settings → Extensions**: download `jobwatch-<version>.mcpb` from the
[latest release](https://github.com/vinayvobbili/jobwatch/releases/latest), 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: the
skill loads there, but the tools don't.
Extras: `jobwatch[score]` (fit scores with the Claude API), `jobwatch[local]` (fit scores with a local model: run
any OpenAI-compatible server, e.g. `vllm-mlx serve`, `mlx_lm.server` or LM Studio, and set `LOCAL_LLM_URL` if it
isn't at `http://127.0.0.1:8010/v1`), `jobwatch[mcp]` (an MCP server for Claude and other assistants), `jobwatch[video]` (drill videos for
interview prep), `jobwatch[lca]` (H-1B wage filings from the U.S. Department of Labor as a second pay source: needs
openpyxl to read its Excel files; see the [watchlist guide](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/watchlist.md)). Prefer a terminal? `jobwatch init`, `jobwatch find "Globex"`, then `jobwatch run` daily.
[More on the page and the command line →](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/the-page.md)
## 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](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/boards.md) · [the watchlist](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/watchlist.md) |
| **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](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/fit-scores.md) |
| **Keeps a short queue** | Today's picks, a queue to apply from, job-alert emails and status emails read for you, reposts caught. [Applying](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/applying.md) |
| **Tailors a resume per job** | With [resume-kit](https://github.com/vinayvobbili/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](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/applying.md#tailoring-a-resume-to-a-job) |
| **Tracks applications** | Every stage, the next step, follow-ups for the ones gone quiet, a calendar feed. [Tracking](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/tracking.md) |
| **Preps interviews** | A prep sheet per interview, answers drafted from your own stories, a mock interview, a drill video. [Interview prep](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/interview-prep.md) |
| **Compares offers** | Pay, career value and company health side by side. [Comps](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/comps.md) |
| **Shows who you know** | Your LinkedIn connections at each company, the people you actually talk to first. [Who you know](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/contacts.md) |
| **Answers questions** | A chat about today's jobs and each posting, and the skills your matches keep asking for. [Chat](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/chat.md) · [Skills](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/skills.md) |
| **Works with assistants** | An MCP server and an agent skill, so Claude can run your search with you. [MCP server](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/mcp.md) |
Everything stays on your computer. The only exception is a model you choose for fit scores and chat: the
Claude API or Antigravity get the posting and your resume (and, for drafted interview answers, your stories);
on-device models send nothing anywhere.
## Why it doesn't auto-apply
Tools that auto-apply to hundreds of jobs make the process worse for everyone and rarely work for the
person using them:
- 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's job is to make sure you never miss a role worth applying to, and to spend your time on those.
[Getting more interviews](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/more-interviews.md)
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](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/README.md).
[Development](https://github.com/vinayvobbili/jobwatch/blob/main/docs/guide/development.md) covers running the
tests and making a release. MIT licensed.
## Support and listings
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](https://ko-fi.com/vinayvobbili) says so too.
[](https://m8ven.ai/mcp/vinayvobbili-jobwatch-1cvk7w?s=readme)
[](https://glama.ai/mcp/servers/vinayvobbili/jobwatch)
[](https://mcpservers.org/servers/vinayvobbili/jobwatch)
[](https://aiagentslisting.com/mcp/jobwatch)
[](https://www.agensi.io/skills/jobwatch)
TDQS
Scored across 32 tools
The set has many closely-related read/list tools (list_jobs, list_queued_jobs, list_applications, get_digest, get_company, get_comps, list_boards), but nearly every description explicitly states which sibling to use instead, which resolves most confusion. A few boundaries still require care — add_application vs mark_job, find_board vs list_suggested_boards vs add_board — though the descriptions draw those lines too.
Every tool is snake_case verb_noun (list_boards, add_board, fetch_jobs, get_job, mark_job, set_comp, save_story, tailor_resume). The verb choice is meaningful and stable across domains (list_ for enumerations, get_ for single-resource reads, import_/read_ for ingestion, set_/save_ for writes).
32 tools exceeds the comfortable range and the surface is broad (boards, imports, email parsing, applications, comps, resume tailoring, interview prep, skill gaps). Each tool does justify itself as a distinct operation, but the count is heavy enough that discoverability suffers and some operations could be consolidated.
The surface covers the full job-search lifecycle end to end: watchlist CRUD, job discovery/import, status transitions, application packages, compensation and company research, resume tailoring, interview prep, stories and skill gaps. No obvious dead ends; even edge cases like duplicate detection, closed postings, and mail-based status proposals have dedicated tools.