Skip to content

Getting started

github-actions[bot] edited this page Nov 17, 2026 · 1 revision

Getting started

Once JobWarden runs (Installation), five minutes make the rest work.

1. Create your profile

The first page asks for a name: that's your profile. It keeps its own jobs, CV, searches, inbox and settings, so several people, or several job hunts, can share one JobWarden. Give it a password in Settings → Your profile if others use the same browser. More on Profiles and settings.

2. Save your first job

Either:

  • With the browser extension (the quickest, from then on): on a job posting, click its icon, then Bookmark or I applied. It reads the title, company, place, salary and description for you.
  • By hand: Jobs → Add job, with the posting's link and what you know.
  • From a spreadsheet you kept so far: Settings → Your jobs → Import (how).

Each job gets a timeline: saved, applied, each interview, the offer or the rejection. Change its status from its side panel, or drag its card on the Pipeline. Interviews, deadlines and days to follow up show on the Calendar, and can remind you.

3. Add your CV

On the CV page, upload your CV (PDF, Word or text), or fill in the fields and let JobWarden build it. Everything the assistant writes for you starts from it: tailored CVs, cover letters, messages, interview prep.

4. Connect your AI assistant (optional)

The AI features (finding jobs for your CV, scoring how well you fit, tailored CVs, cover letters, interview and negotiation briefs...) are done by your own assistant: Claude Code or Codex, on your own plan. Settings → AI Assistant gives the one command that connects it. See AI assistant.

5. Connect your mailbox (optional)

On the Inbox page, connect your mailbox with an app password: JobWarden reads recruiters' emails and offers each rejection, interview or offer as an update of its job. Nothing changes a job without you, unless you say so in Settings → Inbox. See Inbox.

Then

  • The Home page says what waits: jobs to review, emails, follow-ups due, the next interviews.
  • Every page has a How it works button by its title.
  • Missing something? Suggest a feature, in the profile menu.

Clone this wiki locally