AI Job Search

Overview

GitHubGitHub

AI Job Search is a local AI job search application framework built on the Claude Code CLI. It turns Claude Code into an end-to-end job search assistant covering personal profile building, job fit assessment, resume and cover letter drafting, and interview preparation. ### Core Workflow The entire process is driven by a few commands: - **/setup**: Builds your personal job profile by reading a local documents folder (e.g., CV PDFs, LinkedIn exports, diplomas), pasting a single resume, or through guided conversation. - **/scrape**: Searches multiple job portals for roles matching your profile, deduplicates results, and ranks them by fit. - **/apply <url>**: Runs the full pipeline for a specific role—assessing fit, generating a tailored resume and cover letter with LaTeX, then having a reviewer agent audit and refine them before outputting the final versions. - **/rank**: When search results are numerous, batch-scores all roles and generates a ranked shortlist. ### Tech Stack & Requirements The project is written in Python 3.10+, relies on Bun to run job portal CLI tools, and uses a LaTeX distribution (supporting lualatex and xelatex) to compile resumes and cover letters. pypdf can optionally be installed for ATS parseability checks. Note that while the core workflow (profiling, assessment, drafting, and review) is language- and region-agnostic, the built-in job portal search skills currently target the Danish market (e.g., Jobindex, Jobnet). The architecture supports swapping them for portals in other regions. Also, since GitHub does not allow forking a public repository into a private one, and /setup writes personal details like your name, contact info, and salary expectations into tracked files, it is recommended to create a private repository and add this project as an upstream if you only intend to use it for your own job search rather than contribute code.

Q&A

Is this framework free to use?AI-generated

The project itself is open-source under the MIT license and free to use. However, it depends on the Claude Code CLI, which has no free tier—you need a Claude Pro/Max/Team subscription or Anthropic API credits.

Can I use other AI tools like Codex or Gemini CLI instead of Claude Code?AI-generated

Yes. The project provides an AGENTS.md file as a starting point, and the job portal search skills work directly in those tools. Community forks adapting the full workflow also exist.

Why is it recommended not to fork this public repo directly for personal job searching?AI-generated

Because GitHub does not allow forking a public repository into a private one. Running /setup writes personal information such as your name, contact details, work history, and salary expectations into Git-tracked files. For privacy, create a private repository and add this project as an upstream.

Which countries' job sites are supported?AI-generated

The core profiling, assessment, and drafting workflows are region- and language-agnostic. However, the built-in job portal search skills currently target the Danish market (e.g., Jobindex, Jobnet, Akademikernes Jobbank) and are designed so you can swap in job sites from your own region.

What environment do I need to install to run this project?AI-generated

You need Python 3.10+, Bun (to run the job search CLI tools), and a LaTeX distribution supporting lualatex and xelatex (such as TeX Live, MacTeX, TinyTeX, or MiKTeX). pypdf is optional for ATS checks.

What if a job URL cannot be scraped?AI-generated

Some job sites block automated access. If that happens, paste the full job description text after the /apply command instead of providing a URL.