# madslorentzen/ai-job-search

> ai-job-search is an AI job application framework built on Claude Code for running a job search on your own machine. You fork it, fill in your profile, and Claude evaluates job postings, tailors your CV, writes cover letters and prepares you for interviews. The core workflow is written in Python, and the job portal search tools are TypeScript CLIs run with Bun.

Source: https://github.com/madslorentzen/ai-job-search
Indexed: commit d621ebe on 2026-10-20 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Language: Python
- Stars: 72,286 at index time
- License: MIT
- Code health: 8.2/10, Good
- Last commit: 2026-10-19
- Contributors: 88

## Install

From the README: https://github.com/madslorentzen/ai-job-search#quick-start

Clone the ai-job-search repository.
    git clone https://github.com/madslorentzen/ai-job-search.git

Move into the ai-job-search folder.
    cd ai-job-search

Install the job portal search tools from the repository root.
    python3 tools/install_portal_clis.py

## How it works

Work starts in Claude Code skills under .agents/skills, and each job portal has its own search skill. The file .agents/skills/freehire-search/SKILL.md is a central file of the FreeHire search skill and describes how it is used. The entry point .agents/skills/freehire-search/cli/src/cli.ts turns search and detail requests into reads against the FreeHire backend and prints JSON or plain text. The directory .agents/skills/jobindex-search/cli/src fetches Jobindex HTML, turns it into structured results, and renders search lists or job details. The /apply command then runs a drafter-reviewer workflow in which the drafter writes a tailored CV and cover letter in LaTeX, a second Claude agent critiques them, and the drafter revises them. The script tools/install_portal_clis.py runs bun install in each portal CLI before first use, and tools/security_guards.py is one of the utilities that fetch and gate remote content.

- .agents/skills/freehire-search/cli/src/cli.ts: entry point
- .agents/skills/jobbank-search/cli/src/cli.ts: entry point
- .agents/skills/jobdanmark-search/cli/src/cli.ts: entry point
- .agents/skills/jobindex-search/cli/src/cli.ts: entry point
- .agents/skills/jobnet-search/cli/src/cli.ts: entry point
Modules: .agents, tests, tools, root. 249 files, 22,243 lines, 1,994 symbols.

## Code health

- Score: 8.2/10 (Good)
- Rank: #57 of 4,000+ indexed repos
- Hotspots: .agents/skills/jobnet-search/cli/src/commands/search.ts, .agents/skills/jobdanmark-search/cli/src/commands/detail.ts, salary_lookup.py, .agents/skills/freehire-search/cli/src/cli.ts, .agents/skills/freehire-search/cli/src/helpers.ts
- Lowest file: tools/convert_salary_excel.py
- Dead code: 2 findings

## Maintenance

- Last commit 2026-10-19, first commit 2026-03-23, 392 commits
- 88 contributors, bus factor 3

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/madslorentzen/ai-job-search/security

## More

- Page: https://repowise.dev/repo/madslorentzen/ai-job-search
- Ask this codebase: https://repowise.dev/repo/madslorentzen/ai-job-search/chat
- Docs: https://repowise.dev/repo/madslorentzen/ai-job-search/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/madslorentzen/ai-job-search
