jobwatch
by vinayvobbili
README.md
# jobwatch
<!-- mcp-name: io.github.vinayvobbili/jobwatch -->
[](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)
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.
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.
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 ui`, 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
```
pipx install jobwatch # or: pip install jobwatch
jobwatch ui
```
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.
Extras: `jobwatch[score]` (fit scores with the Claude API), `jobwatch[local]` (fit scores on-device, Apple
Silicon), `jobwatch[mcp]` (an MCP server for Claude and other assistants), `jobwatch[video]` (drill videos for
interview prep). 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, Avature, Google, Amazon and HN's Who is hiring. 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) |
| **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.
TDQS
A3.9/5.0
Scored across 30 tools
Disambiguation4/5
Most tools have clearly distinct purposes, and the descriptions explicitly cross-reference adjacent tools such as mark_job vs add_application and get_digest vs list_queued_jobs. There is still some boundary overlap among retrieval/listing tools (get_job, get_company, list_jobs, list_applications, list_queued_jobs, get_digest), though the descriptions generally resolve it.
Naming Consistency5/5
Names are consistently snake_case and overwhelmingly follow a verb_noun pattern: list_boards, add_board, remove_board, get_job, mark_job, save_story, etc. Minor abbreviations like set_comp and get_comps are used consistently and do not disrupt predictability.
Tool Count2/5
With 30 tools, the surface exceeds the threshold where a tool set becomes heavy for an agent to select from reliably, even for a broad job-search assistant domain. Several clusters (jobs, applications, emails, prep, boards, skills) could be consolidated or grouped to reduce cognitive load.
Completeness4/5
The surface covers a remarkably broad lifecycle: board discovery, job fetching/importing, application tracking, email status proposals, interview prep, compensation comparison, contacts, stories, and skill gaps. Minor gaps remain around explicit configuration of watchlist filters/resume, and management operations such as listing or deleting saved stories, but most workflows are covered.
Maintenance
ActivityMaintained
ResponsivenessNo issues