Metadata-Version: 2.5
Name: jobwatch
Version: 0.9.0
Summary: Watch company job boards (Greenhouse, Lever, Ashby, Workable, Workday, Eightfold, Jibe, Rippling, Google Careers, Amazon, Oracle Recruiting Cloud, SmartRecruiters, Avature, iCIMS, Jobvite, careers sites with a job sitemap) and Hacker News' Who is hiring, get a ranked daily digest of new matches (optionally fit-scored against your resume), and track every application. Never auto-applies.
Project-URL: Homepage, https://github.com/vinayvobbili/jobwatch
Project-URL: Repository, https://github.com/vinayvobbili/jobwatch
Project-URL: Issues, https://github.com/vinayvobbili/jobwatch/issues
License-Expression: MIT
License-File: LICENSE
Keywords: ashby,eightfold,greenhouse,job-search,job-tracker,jobs,lever,llm,mcp,resume,workable,workday
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: End Users/Desktop
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business
Requires-Python: >=3.10
Requires-Dist: mcp>=2.2
Requires-Dist: pyyaml>=6
Requires-Dist: ruamel-yaml>=0.18
Provides-Extra: browser
Requires-Dist: playwright>=1.49; extra == 'browser'
Provides-Extra: dev
Requires-Dist: openpyxl>=3.1; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.14; extra == 'dev'
Provides-Extra: lca
Requires-Dist: openpyxl>=3.1; extra == 'lca'
Provides-Extra: local
Requires-Dist: shortlist-ai>=0.2.0; extra == 'local'
Provides-Extra: mcp
Provides-Extra: score
Requires-Dist: shortlist-ai>=0.2.0; extra == 'score'
Provides-Extra: video
Requires-Dist: slidecast[mlx]>=0.4; extra == 'video'
Description-Content-Type: text/markdown

# jobwatch

<!-- mcp-name: io.github.vinayvobbili/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 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.

**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, Avature, Google, Amazon, careers sites with a job sitemap 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) |
| **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)
