JobFinderOS

Open-source AI job search agents for Claude Code. Polls Greenhouse, Ashby and Lever job boards directly, scores roles against your profile, preps interviews, dr

What is JobFinderOS?

Open-source AI job search agents for Claude Code. Polls Greenhouse, Ashby and Lever job boards directly, scores roles against your profile, preps interviews, drafts outreach, and writes it all to an Obsidian vault. A recruiter, a crawler and a market analyst, benchmarked against plain LLM crawling.

Overview of JobFinderOS

What it is

JobFinderOS is a set of agent personas and skills that run inside Claude Code and work for you to identify career opportunities based on your criteria. They watch the market, find roles, keep your pipeline up to date and honest, and get you ready for every interview. They write everything to a folder of Markdown notes, which you can open in Obsidian or any text editor. Three agents exist: Coach (the recruiter), Scout (the crawler), and Mark (the market analyst). All personal data stays local; agents never commit, push, send, or upload anything.

Key features

  • Three specialized AI agents: Coach (recruiter), Scout (crawler), Mark (market analyst).
  • Directly polls Greenhouse, Ashby, and Lever job boards.
  • Scores job roles against your personal profile and scoring rubric.
  • Prepares interview materials, drafts outreach and cover letters.
  • Writes all outputs to a Markdown vault compatible with Obsidian.
  • 25 built-in skills (commands) such as /jobs-daily and /mock-interview.
  • Privacy-first: all data stays local, agents never send or upload anything.

Use cases

  • Automated job search pipeline management.
  • Market analysis and company tracking.
  • Interview preparation and mock interviews.
  • Drafting personalized outreach and cover letters.
  • Daily digest and weekly strategy reviews.

Getting started

Install Claude Code and log in: claude auth login Clone the repository and set up (Python is optional for the scheduler): macOS / Linux git clone https://github.com/matthewprice/JobFinderOS.git cd JobFinderOS python3 -m venv .venv source .venv/bin/activate pip install -r requirements.txt claude Windows PowerShell git clone https://github.com/matthewprice/JobFinderOS.git cd JobFinderOS py -m venv .venv .venv/Scripts/Activate.ps1 python -m pip install -r requirements.txt claude Inside Claude Code, run the onboarding conversation: /onboard Then copy the example board config and run the discovery script: cp config/ats_boards.example.yaml config/ats_boards.yaml python3 scripts/jobfinderos_discover.py Finally, in Claude Code run: /jobs-scout Optional extras include connecting Gmail as an MCP connector, opening the vault in Obsidian, and setting up a scheduler with launchd (macOS) or Task Scheduler (Windows).

License and pricing

Licensed under MIT. Open-source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/matthewpricejobfinderos.svg)](https://yunodb.com/tools/matthewpricejobfinderos?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/matthewpricejobfinderos?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/matthewpricejobfinderos.svg" alt="Featured on YunoDB" height="20"></a>