Skip to main content
Glama
README.md
# 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.

![jobwatch: watch boards, rank by fit, ask about your jobs, track applications, prep for interviews](https://raw.githubusercontent.com/vinayvobbili/jobwatch/main/docs/demo.gif)

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.
[![M8ven Score](https://m8ven.ai/badge/mcp/vinayvobbili-jobwatch-1cvk7w?v=b3794e69984556a0e35f219ef71c5bca)](https://m8ven.ai/mcp/vinayvobbili-jobwatch-1cvk7w?s=readme)
[![vinayvobbili/jobwatch MCP server](https://glama.ai/mcp/servers/vinayvobbili/jobwatch/badges/score.svg)](https://glama.ai/mcp/servers/vinayvobbili/jobwatch)
[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/vinayvobbili/jobwatch)
[![jobwatch on AI Agents Listing](https://aiagentslisting.com/jobwatch/badge.svg?claim=7ad06551a472272d8db3d80aa39a0895)](https://aiagentslisting.com/mcp/jobwatch)
[![jobwatch skill on Agensi](https://img.shields.io/badge/Agensi-skill-2563eb)](https://www.agensi.io/skills/jobwatch)

TDQS

A4.1/5.0

Scored across 32 tools

Disambiguation4/5

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.

Naming Consistency5/5

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).

Tool Count3/5

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.

Completeness5/5

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.

Maintenance

ActivityNo data
ResponsivenessOutdated data