whatisgithub

What is job-agent?

saraswat123/job-agent — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · generalComplexity · 3/5Setup · moderate

In one sentence

A Python tool that automates daily job searching, scores listings against your skills, writes tailored cover letters, and sends applications on your behalf.

Mindmap

mindmap
  root((Job Agent))
    What it does
      Searches job boards
      Scores listings
      Writes cover letters
      Sends applications
    Tech stack
      Python
      SQLite
      Gmail API
    Use cases
      Automated job search
      Cover letter generation
      Follow-up emails
    Audience
      Job seekers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run a daily automated job search across LinkedIn, Naukri, and general web results

USE CASE 2

Auto-generate a tailored cover letter for each matching job posting

USE CASE 3

Send applications with your CV attached via the Gmail API and avoid duplicates

USE CASE 4

Automatically follow up on applications seven days after sending

What is it built with?

PythonSQLiteGmail APIClaude Code

How does it compare?

saraswat123/job-agent0-bingwu-0/live-interpreter0xkaz/llm-governance-dashboard
Stars222
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/52/54/5
Audiencegeneralgeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires Gmail API credentials and a Claude Code setup for cover letter generation.

So what is it?

Job Agent is a Python tool that automates the daily process of searching for jobs, writing cover letters, and sending applications, all without manual effort after the initial setup. Once configured, it runs automatically every morning, searches multiple job boards, scores results against your skill profile, extracts recruiter email addresses, generates a tailored cover letter for each role, and sends applications with your CV attached. The search stage pulls listings from LinkedIn and Naukri, as well as general web search results. Each listing gets scored from 0 to 100 by a keyword-matching engine that weights domain-specific terms more heavily than general ones, only jobs above a minimum threshold move forward. Recruiter email addresses are found by scanning each job description, then falling back to a web search, then crawling the company website if needed. Cover letters are generated using Claude Code, which reads the job description and writes a short, tailored letter under 200 words. Applications are sent via the Gmail API with your CV auto-attached, and each submission is logged to a local SQLite database to prevent duplicates. For job sites that support one-click applications, a browser automation layer fills out and submits forms directly. Seven days after each application, the tool automatically sends a follow-up email. The project is aimed at job seekers comfortable using a terminal who want to run a high-volume, consistent outreach campaign with minimal daily involvement. The full README is longer than what was provided.

Copy-paste prompts

Prompt 1
Help me set up Job Agent to search LinkedIn and Naukri for roles matching my skill profile
Prompt 2
Explain how Job Agent scores job listings and filters out low matches
Prompt 3
Show me how Job Agent finds recruiter email addresses for a listing
Prompt 4
How do I configure Job Agent's Gmail API integration to send applications with my CV?

Frequently asked questions

What is job-agent?

A Python tool that automates daily job searching, scores listings against your skills, writes tailored cover letters, and sends applications on your behalf.

What language is job-agent written in?

Mainly Python. The stack also includes Python, SQLite, Gmail API.

How hard is job-agent to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is job-agent for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.