Guide

How DotHub works, page by page. Setting up a server is in docs/SETUP.md in the repo.

How it fits together

A Grok bot runs the job search on a schedule (Settings → Run schedule, Monday and Thursday mornings by default). It scans job boards, scores every posting against your resume, writes a tailored resume and cover letter for the good ones, and commits the run to the CareerDotHub repo. DotHub pulls that repo every 30 minutes and turns each run into a plan. DotHub only reads from the repo; it never pushes to it.

Picks
Each run brings a ranked list of picks (10 by default, up to 20). The score (1 to 5) sets the match tier: Apply now!, Great Match, Good Match or Low Match. You can move the cut-offs in Settings → Match tiers.
Within reach
The badge beside the tier compares the experience a posting asks for with your Years of experience (Application kit) and your resume: Within reach, Stretch or Long shot. The tier says how well a job fits you; this says how likely they are to consider you. Hover or tap it for the reasons.
Statuses
Every job is Suggested until you act: Saved, Applied, Interviewing, Offer, Rejected, No response or Skipped. Changes have an undo, and each one is kept on the job's timeline.
Your data
Statuses, notes, contacts, offers and the kit live in DotHub's own database on the server, with a backup every day.

Today

Start here. The briefing at the top lists what wants you today, most urgent first: interviews in the next two days, follow-ups due, postings that changed, debriefs to write, emails to look at and new picks.

Cards
One per pick, with the fit note, pay, flags, and the resume, cover letter and report the bot wrote. Apply opens the posting; DotHub then asks whether you applied.
Apply mode
Today's unreviewed picks one at a time, with the posting, PDFs and your kit facts beside each. Answer "I applied", "Skip" or "Not now" and the next one comes up. Open it with the Apply mode button or M.
Keyboard
J/K move between jobs, A opens the posting, Y marks it applied, S skips, O opens the job page, ? lists them all.
Sundays
The briefing adds a line for your week in review (see Week).

A job's page

Open any job's title for everything about it in one place.

Saved posting
DotHub saves the posting's text when it's first picked, so you still have it after the listing comes down. It re-checks the jobs you're pursuing and tells you when the text changes (pay added, requirements moved), with a before-and-after diff.
Interview
The day, time, length and link, a prep checklist, and a debrief after. If an interview invite is in the inbox, "Fill in the interview" copies the time and link from it.
Contacts and notes
Recruiters and hiring managers for the job, and your own notes. The main contact is who follow-up drafts go to.
Grok on the job
Decode reads between the lines of the posting. Interview prep, follow-up drafts, a tailored answer from your kit, and help negotiating an offer are all one click.

Keeping track

Tracker
Every job you've touched, filterable by status, with bulk changes.
Follow-ups
Who to nudge and when: a check-in some business days after applying, a thank-you the day after an interview, and a prompt to close a job out as No response. Log a follow-up, snooze it, or change the rules in Settings.
Inbox
Optional. DotHub reads a dedicated Gmail inbox (read-only), matches employer replies to jobs, and suggests the status change, such as Interviewing for an invite. Nothing changes until you accept.
Week
Monday to Sunday at a glance: interviews, offer deadlines, follow-ups due, what you sent and new picks. Below it, the week in review: what you sent, who replied, interviews, and what's coming next week.
Work-search log
Every application, follow-up and interview in a date range, in the columns unemployment work-search forms ask for. Pick this week or last (Sunday or Monday first) or any dates, then download a CSV or print it to PDF.
History
Every past run by day, with its picks and documents.

Seeing the patterns

Stats
Applications by week, reply and interview rates, how long replies take, and which kinds of roles answer.
Pay
What the jobs you're seeing really pay, by role type, and your offers side by side with the yearly and first-year totals. Grok can draft a counter from there.
Skill radar
The skills your best matches ask for, and which ones your resume doesn't mention yet.
Application kit
The facts every form asks for and your saved answers to the questions they repeat, ready to copy.

Dot

Dot is the mint dot from the logo, with a face. It sits in the sidebar and beside Today's greeting, and it never interrupts: it only talks when you click it.

Moods
Dot's face follows the background glow: relaxed when all is clear, looking up when something's due, worried when something broke, and asleep in quiet hours. It hops when you finish reviewing a run's picks and puts on a party hat for an offer.
Click it
One short line about the most useful thing right now, with a link to where it's handled.
Accessories
Dot earns one for things you do, like your first application, your first follow-up or a complete Application kit, never for how a search turns out. Pick what it wears in Settings → Dot.
Search wrapped
When an offer lands, Dot walks you through the whole search: days, jobs picked, applications, replies, your biggest week, the skill asked for most and the path to the offer. The last slide saves as one image.

Grok

The dock at the bottom of every page knows which page you're on and which job you're looking at.

Copy for Grok
Without an API key, DotHub builds the question with the job data and copies it; you paste it into grok.com, which answers on your subscription.
In-app answers
With an xAI API key on the server, answers stream into the dock. A daily budget (Settings → Grok) stops it before it spends more than you set.
Cover letters
"Write cover" on a card without one writes a letter from your resume text (Settings → Grok) and saves it as a PDF.

Settings

Run schedule
Which days and at what time the bot runs, and how many picks. DotHub can't change the bot itself: after saving, copy the message it gives you into the Grok chat.
Bot token
The bot's GitHub token expires every 90 days. The status bar warns you ahead of time; Settings has the steps to rotate it.
Phone notifications
Turn them on for each phone or computer: interview invites and other replies, new picks, a morning briefing at 8, postings that changed, and anything that broke. Quiet from 10 PM to 7 AM unless you turn that off. On an iPhone, add DotHub to the Home Screen first and turn them on from there.
Backups
A copy of the database every day (the newest 14 kept), with a second copy on another drive when one is set. Back up now makes one on the spot.
Security
Sign-in is a password and an authenticator code. Settings shows your sessions, recovery codes left and recent failed sign-ins, and can sign out every device.