Find jobs and track your applications with the AI agent you already use
A local app that has your agent search for postings that match your profile, checks every link itself, and turns Gmail replies into status changes you accept. No agent setup with Claude Code.
How it works
Drop your CV, get a profile
The app reads the text of your CV and your agent suggests target roles, locations, remote preference and seniority.
Your agent finds jobs, the app checks every link
Your agent searches the web for matching postings; the app checks every link itself and shows how each job fits.
Mark one applied
Mark a job applied and it joins your applications, with its status tracked from there.
Sync Gmail, review what it found
Your agent reads the replies in your Gmail and proposes status changes with the evidence. Nothing changes until you accept.
See where everything stands
The Dashboard counts what is in progress, shows how far applications get and where they stopped, and lists what needs your attention.
Why you can trust it
It is a single-user tool that runs on your machine and works through your agent.
Data stored locally in SQLite
Profiles, jobs, applications and your CV are kept in a data folder on your disk. The app’s server listens on 127.0.0.1 only, so other machines cannot reach it.
Your own agent
The app runs the agent CLI you already use: Claude Code by default, or Codex or a custom command. Your profile, the text of your CV and the mail it reads go to that agent, like any other prompt you give it.
Nothing changes until you accept
Gmail sync proposes status changes and new applications, each with the sender, date, subject and a snippet as evidence. You accept or reject them.
It never applies or sends mail
The app never applies to jobs, sends mail, or changes your labels or messages. For Gmail sync, Claude Code is by default allowed only the search and read tools; Codex gets whatever access its own Gmail MCP server allows, and is told to only read.
Works with your agent
Claude Code is the app’s default agent; Codex and custom commands work too.
Run it
The first start asks where to keep your data; press Enter for the default. The app then opens in your browser.
npx job-applications-trackerPick your agent
With Claude Code installed, the app uses it and skips Setup. If your chosen agent is not installed, Setup opens, where you pick Claude Code, Codex or a custom command. Change it later in Settings → Agent.
Connect Gmail (optional)
For Claude Code, connect Gmail once in your claude.ai account; sync uses the claude.ai Gmail connector. For Codex or a custom command, set up a Gmail MCP server in that agent yourself.
Watch a walk-through
About a minute and a half, with captions and no sound. It uses invented data and a stand-in agent.
Install
Run it once with npx, or install it globally for the short command.
Run without installing
npx job-applications-trackerOr install globally
npm i -g job-applications-trackerjobtrack- Requires Node 22 or newer.
- The app starts on http://127.0.0.1:4173 (or the next free port) and opens your browser.
Questions
Can I use another agent instead of Claude Code?
Yes. Pick Codex or a custom command in Setup, or later in Settings → Agent. For Gmail sync, set up a Gmail MCP server in that agent yourself; the app cannot do it for you.
What does the app send to the agent?
For a CV analysis, the text read from your CV (not the file). For a job search, your profile fields, including Notes, and the links of the 200 newest jobs you already have. For Gmail sync, the agent searches and reads your mail, so it sees the messages it finds. That content reaches your agent’s model the same way your other prompts do.
Where does my data live?
In ~/.job-applications-tracker/ unless you choose another folder on the first start. It holds data.db (SQLite), your CVs and the run logs. Change it later with jobtrack config set data-dir <path>, or npx job-applications-tracker config set data-dir <path> if you run it with npx.
Does it work on my phone?
No. The interface is for desktop browsers only: Chrome or Edge 111+, Safari 16.4+, or Firefox 128+.
What does it cost?
The app is MIT-licensed. Searches and syncs run on your agent’s plan (Claude Code or Codex), and each job search’s and Gmail sync’s Run page shows what it used. A Max-effort search uses several times the tokens of a normal one, so it asks before it starts.
What do I need?
Node 22 or newer and an agent CLI: Claude Code by default, or Codex or a custom command. Gmail sync also needs a Gmail tool in that agent; for Claude Code, that is the claude.ai Gmail connector.