Job Tracker

Track every job application in one place, privately, on your own computer.

A free, open-source job application tracker. Add jobs by hand, or let an optional, read-only Gmail scan find your application confirmations, interview invitations, offers and rejections and update the tracker for you. There is no account to create and no cloud service: your data stays in one file on your machine.

Project page: https://jobtracker.vedijapillay.dev/ · Privacy policy: https://jobtracker.vedijapillay.dev/privacy.html

Try it in 30 seconds

You need Node.js 20.17 or newer.

git clone https://github.com/vedijapillay/job-tracker.git
cd job-tracker
npm run setup
npm run demo

Then open http://localhost:3000. The demo has sample jobs and a simulated Gmail scan, so you can try everything, including adding a job from an email, without connecting Google. It runs on its own temporary database, never touches your real data, and resets every time you start it. Press Ctrl+C to stop it.

What it does

• One dashboard for every application: company, title, status, source and date.
• Statuses that match a real job search: Applied, Recruiter Screen, Technical Round, HM Round, Interview Scheduled, Offer, Rejected, Declined by You, Ghosted.
• Filter by status or source, delete one job or many at once, and export to CSV whenever you like.
• Optional Gmail scan that finds job emails and suggests changes. You review every suggestion. Nothing is added automatically.
• Insights tab: a funnel from applied to offer, outcomes, applications per week and which sources work best. It is calculated on your computer from your own jobs. Try it in the demo.
• No duplicates: if an email is about a job you already track, the app offers to move that job forward (for example Applied to Rejected) instead of adding a second row.
• Private by design: no accounts, no analytics, no server run by anyone but you.

Use it for real

npm run setup    # once: installs dependencies and builds the web app
npm start        # runs everything on one port

Open http://localhost:3000. The tracker works fully without any Google setup. Your jobs are saved in jobs.db in the project folder.

Gmail scanning (optional)

Click Scan Gmail (or Gmail setup) and the app walks you through connecting your inbox.

Why you create your own Google project. Reading email is a sensitive permission, so instead of sharing one project between everyone, you create your own free Google Cloud project once (about 10 minutes), paste its Client ID and secret into the app, and click Save and test. Nothing is shared with anyone, and your emails never leave your computer.

One tip that saves you a weekly chore: after creating your credentials, open the consent screen's Audience page in Google Cloud and click Publish app. It's your own personal project, so Google doesn't review it. Without this, Google asks you to sign in again every 7 days. You'll see a "not verified" warning when you sign in; choose Advanced, then continue.

Developers can put GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET in a .env file instead (see .env.example). Credentials saved in the app take precedence.

What the scan does

• Reads recent inbox emails (up to the last 180 days) that mention job-related words. It skips Gmail's Promotions and Social tabs, except for mail from known job sites and application systems.
• Decides on your computer whether each email is an application confirmation, interview or screening, assessment, offer, rejection or withdrawal, and picks out the company and job title when it can.
• Shows you the results. For each one you can add it, update an existing job, edit it first, or click Not a job email so it never shows up again.
• Never sends, changes or deletes email. The permission it asks for is read-only.

Limits you should know about

• The classifier is rule-based, not AI. It works on English-language emails and will sometimes miss one or get one wrong, which is why you review every result.
• A recruiter writing from a personal address (Gmail, Outlook and so on) may show up with the company "Unknown". Fill it in before adding.
• It reads the inbox only, and only Gmail is supported today.
• Automated tests run on Linux and Windows for every change. The real Gmail sign-in has so far been tried by hand mostly on macOS, so tell us if something breaks elsewhere.

Privacy

Job Tracker runs on your computer. There is no Job Tracker server, account or cloud service, and the app contains no analytics or tracking.

• Your jobs are stored in jobs.db in the app folder, on your machine.
• Gmail scanning is optional and read-only. Email content is processed on your computer, and email text is not saved.
• To scan without asking you to sign in every time, the app saves a Google sign-in token in jobs.db (and your Google client ID and secret, if you enter them in the app). Protect that file like your other personal files. Disconnect Gmail deletes the token, and you can revoke access any time in your Google Account permissions.
• The only outside service the app talks to is Google, to sign you in and read your Gmail.
• The server only listens on 127.0.0.1, rejects requests with an unexpected Host header, and refuses cross-site requests, so other devices on your network and other websites can't read your jobs or use your Gmail connection.

Read the full Privacy Policy.

Your data

Everything is in one SQLite file, jobs.db, created on first run.

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗