jobtracker

Score job postings, tailor resumes, and track applications with AI agents. Agents and skills for the coding agent you already use, paired with a local CLI (jobtracker, or jta). Your job-search data — scores, applications, resume content, preferences — lives in its own directory you control, never inside this package.

Quick Install

curl -fsSL https://jpatrickb.github.io/jobtracker/install.sh | bash

Installs via uv or pip, then launches the setup wizard: picks a data directory, then offers to run npx jobtracker-agents — pick which coding agent(s) you use and it installs the right files for each, plus your skills. On Claude Code or Codex, it can then drop you straight into a live session that's already running the preferences-onboarding skill, so the interview (hard gates, qualitative preferences, resume import, rubric weights) starts immediately. Not on Node? The wizard prints the equivalent manual commands instead — see Supported Platforms below.

Supported Platforms

npx jobtracker-agents

Lets you pick which agent(s) you use (Claude Code, Codex, Kilo Code, Cursor, Pi) and installs the right files for each, then offers to install skills too. This is what the setup wizard runs for you; run it yourself anytime to add another agent later, or if you skipped it during setup.

Skills need no per-platform port — npx skills add jpatrickb/jobtracker installs all 4 (resume-update, resume-onboarding, submit-application, preferences-onboarding) on any of the above via Agent Skills. jobtracker-agents offers to run this for you too.

AGENTS.md (not CLAUDE.md) is the data directory's instructions file — an agent-agnostic convention several tools converge on.

Manual Setup

pip install jobtracker   # or: uv tool install jobtracker / pipx install jobtracker
jobtracker setup         # or: jobtracker init [path] for a non-interactive equivalent

Then run npx jobtracker-agents (or see Supported Platforms above for manual steps).

What's Inside

Agents — dispatch directly, run several in parallel, one instance per posting.

Skills — conversational, run inline in your session, not for bulk dispatch.

The Rule

No claim, number, or rewrite goes on a resume or cover letter unless it traces to a verified item in your evidence ledger, a measured value, or a signed-off estimate. Every agent and skill defers to this.

Data Directory

~/JobTracker/
├── .jobtracker/          # applications.json database
├── RUBRIC.md              # scoring weights
├── PREFERENCES.md         # hard gates + preferences
├── SCORING.md              # scoring-stack version
├── corrections.md           # scoring corrections log
├── anchors/                  # calibration jobs
├── listings/                  # posting text + extracted facts
├── inbox/                      # postings waiting to be scored
├── applications/                # one folder per tailored application
├── resume/                       # EVIDENCE.md, BULLETS.md, VOICE.md (optional)
└── AGENTS.md, CLAUDE.md            # agent instructions (CLAUDE.md is a symlink)

Customizing

License

MIT