Repository navigation
Dossier 1.15.0
Dossier 1.15.0
A new look for every screen, every job portal you choose searched at once into one library of postings, a catalog of portals to add, several profiles, one answer to how well a posting fits, and notifications by email, webhook or ntfy. An application's page gets a Fit column, Ask, interview rounds, offers and follow-ups drafted on a click; New application writes on the server, so you can leave it; and an application you sent before Dossier can be added without documents. Scores out of 100 give way to how many of a posting's requirements you cover. Fixes for cookie notices read as postings, the desktop app signing you out, mail matched to closed applications, old status suggestions, a radius in Australia, and Startups showing people looking for work as companies.
What's new
- A new look: every screen after you sign in is redrawn. The sidebar groups them into Track, Find work and Your profiles; each application status has its own line with its count, and each profile its strength and Base resume. Jump to, in the sidebar or with Ctrl+K (⌘K on a Mac), finds a screen, an application, a posting, a profile or a part of Settings as you type, from the keyboard too. New application has one button, in the sidebar. An application's page opens with the sidebar folded, so the documents get the room, and keeps that apart from the other pages. Lists, menus and panels share one thin scrollbar.
- Positions, one library of postings (#11): Find jobs kept a list for each search. It's now Positions, which keeps every posting your searches and the job agent find, once, with tabs for All open, New, Saved, Applied for, Dismissed and the Archive, filters for the search that found it, the portal and how recent it is, and Best fit or Newest order. The same job from several portals is one posting, "also on Adzuna", with the fullest details of each. Dossier merges only what's clearly the same job, never across companies, cities or levels, and Not the same job splits a wrong merge; a job you dismissed or applied for stays so, whichever portal brings it back. What you leave untouched moves to the Archive 30 days after a search last found it (14 to 90 in Settings → Job search), with Move back and Remove; nothing is removed on its own. Thanks to @hschaefer, who sketched it.
- Every portal at once: Settings → Job search chose one source. It now lists every portal, each with its own switch, key and Test connection, and you switch on as many as you like. A search asks all of them that list jobs in its country, in the background: Positions opens at once and fills in as each answers, with a bar showing which answered, failed or were skipped, and why. A failed portal has Try again while the others carry on, Show more asks only those with more, and you can leave the page meanwhile. The job agent asks the same portals, up to 3 times a day each instead of 3 times in all, and still never the Bundesagentur für Arbeit.
- Portals from a catalog, or your own (#79): a portal is now a small JSON file that one engine reads: a JSON API, an RSS or Atom feed, or a page with schema.org job postings. It never runs code on your server, and your searches and key go only to the hosts it lists. Browse portals in Settings → Job search lists the reviewed ones from the public catalog, AienTech/dossier-portals: besides the four built in, Greenhouse, Lever and Ashby for the job boards of companies you list, and Remote OK, Remotive, Himalayas and Jobicy for remote work, each with its terms, whether it's free, and every host it reaches. Add portal takes a file or a link, marked Not reviewed unless the catalog reviewed exactly that. An added portal stays as it is until you install an update, and a new host needs your OK; one the catalog withdraws is paused until you look at it. Thanks to @Swissschoggi for asking for it.
- Several profiles (#93): keep a backend and a frontend profile, or a developer's and a welder's, each with its own headline and summary, roles, projects, skills, education and the rest, and its own Base resume. Your name, contact details, photo, languages and facts about you are shared. New profile, from the switcher on Profile and Base resume or the sidebar's +, starts empty, as a copy, or read from a resume file. New application asks which profile to write from, starting with the one that covers a posting from Positions best; each of the job agent's searches has one, or all of them (scoring each posting once per profile); and Claude's tools take one by name. Each profile says which levels it's for, from Internship to Lead or director (or Guess with AI), and where it wants to work: on-site or hybrid within a distance, remote for employers in which countries, and whether you'd move. Your own sections say what they Count as: Work experience, Education or Extra activities. Thanks to @shuklamanan for asking for it, and to @IliaAvdeev, whose two trades that share nothing shaped it.
- One answer to how a posting fits: the score and How you match were separate readings. Now one engine does both: a scoring model answers the same questions about a posting and a profile, for each requirement whether it's a must-have or a nice-to-have and whether the profile shows it, then your work experience, extra activities, education, level and place. Positions, New application, an application's Fit column and the job agent show how many requirements you cover as a ring ("5/7"), with the rest as reasons. A posting can be scored against one profile or all of them and shows the best, and its answers are reused when you start an application from it.
- OpenAI Decisions and OpenRouter for scoring (#105, #133): Settings → Scoring offers four scoring models: your AI model, Jev, OpenAI Decisions, through OpenAI's Decisions API with
gpt-6-luna, and OpenRouter, with the model you choose (openai/gpt-6-lunato start), which is asked to use only companies that don't keep or train on what they get. Each has its own key and Test connection; your AI provider still writes the documents.DOSSIER_SCORERtakesopenai-decisionsandopenrouter. Thanks to @MichaelDanCurtis, whose adapter this one is built from, and to @suleman1412 for asking for OpenRouter. - Notifications (#115): Settings → Notifications takes channels: Email through your SMTP server, a signed Webhook with the whole event as JSON, for n8n and the like, and ntfy, on your own server or ntfy.sh, with an optional access token. Send a test tries one at once, and a grid sets which events go where. On by default: Agent run finished, after each scheduled run, with each search's new postings, the best of them and any portal that failed; Documents written; and a portal you use being withdrawn. Off until you switch them on: a portal update, a draft the agent prepared, a reply, an interview tomorrow, a follow-up due, and a new version. Messages carry a title, a short text and a link back, never your profile, documents, a posting's text, mail or keys. Failed deliveries are tried again, and a channel that keeps failing is paused. Links use
DOSSIER_PUBLIC_URL, or the address you last opened Dossier at; Notifications in the wiki shows how to check a webhook's signature. Thanks to @anushibinj for asking for it. - The dashboard: it opens on the date, a greeting and how many things need you this week. Needs you replaces Worth a look: what's overdue or due within 7 days, replies first, then what needs you without a date, each with a button for the next step. The funnel's four figures (sent, heard back, reached interview, offers), each stage and ending, and Where things stand's statuses open their applications. The period applies only to "Your search so far", and the calendar lists the next 7 days. On top, a short, kind note in handwriting, new each day: the AI writes it with nothing about you in it, Another one gives up to three a day, and Hide for today puts it away. Without an AI provider, or with Write the daily note with AI off in Settings → AI provider, Dossier picks one of its own.
- Applications by status: a status opens as a list with its own columns: Apply by and Docs ready for drafts, how and when it was sent and how long it's been quiet, the last reply, the next interview and round, an offer's salary and Decide by, then the next step. On the board, lanes share the width, the closed ones fold into narrow columns, and ☰ opens a lane as a list. A card says what's next ("Quiet for 14 days", "A reply is waiting", "Apply by Sat 3 Oct · 3 days"), with a button for it. A card dropped on Interview asks when, and can add it to Google Calendar, and Mark as sent asks how it went out: "Sent 2 Nov by Gmail".
- The application page: the header fits in one row, with "Role at Company", the tabs, the status and one next step. Beside the documents, the Fit column lists what the posting asks for and whether you cover each; pick one and the lines that serve it light up, or it says "Addressed in paragraph 4". A gap's Add to profile asks where you used it and what you did, adds it to that role and offers to rewrite the role; I don't have this marks it known. Below 1500 px wide the column folds into a rail. Each document has one row of tools, the letter's with tone and language, which write it again. The refine panel is a box at the bottom of the page, one history covers the resume, letter and email, with Undo and Go back to this, and a change scrolls into view, marked, with Keep · Undo. Check again checks the requirements against your profile as it is now.
- Ask about an application (#132): the box at the bottom of an application has Change and Ask. Ask answers a question, such as how you meet a requirement on a screening form, from the profile, the posting and the application's facts, never your notes, and changes nothing. Its answers stay in the history. Thanks to @muhdusama for proposing it.
- Interviews, offers and follow-ups: an interview date, typed in, agreed in Gmail or from the calendar event, fills in that round with its length, place and who's invited; the next date starts the next round, and So far lists the past ones. Prepare has the AI write a Getting ready checklist from the requirements and the interview, and keeps your ticks. An offer keeps its salary against the posted range, start date, holidays, office and Decide by, typed in or read from the offer email, with Draft an acceptance, Ask for more and Decline politely. Follow up drafts a follow-up. Each draft is written only when you click, and goes out in the Gmail thread once you confirm, or waits to be copied or opened in your mail app, with I sent it.
- New application (#111): it starts with one box for the posting or its link, the profile to write from and Read the posting, or with one you saved or the agent found this week. Each step has its own address, so Back and a reload stay on it. The review happens on the application's own page: what was read, Show the posting with each requirement marked, the Fit column, and How to write it, with the tone, this application's language and "Anything I should know?". Write resume and letter makes the Draft at once and writes it on the server, so you can leave the page; Stop keeps what's written. Save it for later puts the posting in Positions instead. Thanks to @BanisharifM for asking for the steps' addresses.
- Add an application you've already sent (#129): Already sent it? Add it without documents, in New application, takes the company and role, the day you sent it and where it stands, with the posting and link if you have them. Nothing goes to the AI, so it works without a provider, and it counts as sent from that day. Thanks to @isaiah1112 for asking for it.
- What your profile is missing: the strength meter names the next thing to add, the section list says which sections are done or need a look, and a role says how many tailored resumes use it. Asked for, not in your profile lists the skills that the postings you saved or applied for in the last 90 days ask for most and the profile doesn't show, and your latest role asks about the top one: "Did anything at Northwind Logistics touch it? Only add it if it's true." It's counted on your server, without AI.
- Settings at a glance: Settings opens on an overview, a card per section saying On, Needs a look or Off and what it's set to, with a banner for what to fix first, such as a failed connection test or a portal out of searches. AI provider shows each provider as a card saying whether it runs on your hardware or is hosted, a saved key's last four characters with Replace, the last connection test, and where your data goes. "Your data" is now Data and backups.
- Startups and the job agent: both now look like Positions. Startups has Hiring now, New, Saved, Applied for (Contacted before) and Dismissed, says where a startup hires from, and is matched against every profile; Score scores a startup's post with your scoring model instead of the keyword match. The Agent screen has Drafts to review, Best finds and Skipped, which says why a posting was left out: below your cut-off, past the run's scoring limit, already in Positions, or dismissed before.
- Claude changes a saved Draft (#116): asked for a change after
save_application, Claude could only save a second application. The newupdate_applicationchanges the resume, cover letter or match of a Draft, with a version for each change, the same checks against your profile, and the letter's sender, date and signature kept; anything past Draft is refused. Thanks to @KrishKoria, who sent it (#143). - Move a reply to the right application (#134): a reply in an application's Conversation tab has Not about this application?: move it to another application, or unlink it so it waits under Needs a look in the Inbox. Its thread goes with it, and later replies follow. Thanks to @suleman1412 for asking for it.
Changed
- What you cover, instead of a score out of 100: Positions, Startups, the job agent and applications showed a score out of 100. They now show how many of a posting's requirements you cover, and the rest of what the scoring model judges shows as reasons, which don't change the order. Best fit sorts by the share covered, then fewer missing must-haves, then the newest. Positions' Score filter is now Covers (Any, At least half, At least two thirds, All of them), and the job agent's minimum score is Keep postings that cover, with your setting carried over. The tailored resume's score is gone, with the Applications table's Score column; Check again checks an application's coverage anew.
- What the scoring model reads: every part of the profile it scores against, now including items you keep off resumes, since hiding one is about a resume's length, not about what's true, and the profile's levels and where it wants to work. Your name, contact details, references and links are still never sent; PRIVACY.md has the details.
- "Quiet for" starts over with mail: it counted from the send or the last change, so an application with a reply last week still looked quiet. It now counts from the latest of those or any mail in or out, on the dashboard, the board and in notifications.
- The Base resume's language: it moved from Settings → Documents to each profile's Base resume, with its theme, sections and Fit to one page.
- The setup guide: the Job search step asks where you're looking and what kind of work, then lists every portal that covers it, built in or reviewed in the catalog, to tick several, with a key field where one is needed. The Scoring step offers the four scoring models.
- A breadcrumb on every page below another (#112): an application's page showed "Applications /" without the page itself, and other pages had none. Each page below another now has one, such as "Settings / AI provider", with the current page last. Thanks to @BanisharifM for asking for it.
- Google sign-in with PKCE: Connect Google now proves it's the same browser that started, so a sign-in code that leaks on its way back is no use to anyone else.
- Discord and Buy me a coffee: the sidebar has Join us on Discord, where people looking for work help each other get hired, and Buy me a coffee beside Star on GitHub. The desktop app's Help menu has both.
- New rows in Usage: the daily note, Guess with AI, Getting ready, drafted messages, Ask, and OpenAI Decisions and OpenRouter each count on their own row.
Fixes
- A cookie notice read as the posting: Fetch could read a site's cookie banner, menu or sign-up form as the posting, and the documents were written from it anyway. Banners and dialogs are now taken out first, in any language, a page that's mostly links says so, and text that isn't a posting stops the reading with a plain message; the job agent writes no draft from it.
- The desktop app signing you out: On my server, you signed in again on every launch unless you ticked "Keep me signed in for 30 days". The app now always keeps its session, and doesn't offer the box. Browsers sign in as before.
- Mail matched to a closed application: a new mail could be linked to an application you'd been accepted, rejected or declined for. Closed applications are no longer matched, so the mail waits in the Inbox; a reply in a thread already linked to one still goes there.
- Old status suggestions: each of an application's mails could suggest a status, so an older one read later could offer an older status. Only the newest mail's suggestion shows now, and archiving the application clears it.
- The From line before sending: "Send this application?" showed only your Gmail address. It now shows the From line as the mail goes out, with your name.
- The Inbox without an AI provider: with Gmail connected and no AI provider, only an opened mail said that replies are linked but not read. The Inbox now says so once, with a link to Settings → AI provider.
- A radius in Australia (#138): with a radius, JSearch found nothing in Australia, and Within had no way to leave it out. Within now has Any distance, which sends no radius to any portal. Thanks to @JeanLoureiro for reporting it, and to @AlienBTw, whose fix (#142) did the same.
- People looking for work shown as startups (#144): some people post their own profile in Hacker News's "Who is hiring?" thread, and their first line became a company. Posts in the first person, ones that say they're looking for work, and ones in the "Who wants to be hired?" form are left out now, and untouched ones read before are tidied away. Thanks to @shuklamanan for reporting it.
- A role listed twice on a startup (#137): a role written twice in a Hacker News hiring post was kept twice, which the page couldn't show properly. It's kept once now. Thanks to @sun01822, who sent the fix (#136).
For contributors
A job portal is a JSON file now. To add one to the catalog, send it to AienTech/dossier-portals, whose README and CONTRIBUTING.md have the format and the rules: official APIs and feeds, or sites whose terms allow automated access, and only the portal's own hosts. A notification event is one entry in a list and one call where it happens; DEVELOPMENT.md says how.
Upgrading
Take a backup, then deploy ghcr.io/aientech/dossier:v1.15.0 (see Upgrading in the wiki). On its first start, Dossier updates the database, on PostgreSQL and SQLite alike, and moves what you have into the new shape. The job source you chose becomes the one portal switched on in Settings → Job search, with its key; environment variables such as DOSSIER_JOBS_SOURCE still apply until you save there. Find jobs' searches, saved and dismissed postings and the job agent's finds move into Positions, and postings you haven't saved, applied for or dismissed that no search has found in the last 30 days go straight to the Archive, where Move back returns them. Your profile becomes the first profile, named after its headline ("My profile" without one), with the Base resume's settings and language, and your applications and the job agent's searches use it. It starts out on-site or hybrid within 50 km of your city, remote for employers in your country and not moving, and Profile asks you to check that. Your own sections count as Extra activities, an application's next interview becomes its first round, and the job agent's minimum score becomes a cut-off: 50 to 65 is at least half, 70 to 85 at least two thirds, and 90 or more all of them.
Choose your profile's levels before you score. A profile from before has none, and Dossier never guesses them on its own: set them under Profile → Jobs it's for, or press Guess with AI. Until then, Score says where to set them, New application reads a posting but How you fit waits, and the job agent keeps what it finds without scoring it. Postings scored before 1.15 keep their reasons, marked as an older score, but have no requirements to count, so their ring shows "–" and they sort last until you score them again. Resumes and letters written before 1.15 don't mark which of their lines serve which requirement.
In the desktop app, download the new version from this release and install it over the old one: it also brings Electron 45.3.3, with its security fixes. On this computer, background searches, the job agent and notifications run only while the app is open.
Exports now include your profiles, the portals you added and how each portal is set, Positions with its Archive, notification channels and their events, interview rounds, offers and drafted messages, the gaps you don't have, and what the job agent skipped, so a 1.15.0 export can't be imported into an older version. Exports from older versions import as before, into one profile. The scoring models' keys and the notification channels' passwords, tokens and secrets are never exported, and an import keeps the ones this install has.