Job Applications TrackerGitHub

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.

npx job-applications-tracker

Requires Node 22 or newer.

View on GitHub

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.

Why you can trust it

It is a single-user tool that runs on your machine and works through your agent.

Works with your agent

Claude Code is the app’s default agent; Codex and custom commands work too.

  1. 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-tracker

  2. Pick 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.

  3. 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-tracker

Or install globally

npm i -g job-applications-tracker
jobtrack

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.

Documentation