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

Inbox

Recruiters' emails, read from your own mailbox, turned into updates of your jobs' timelines.

Inbox (/inbox): recruiters' emails, read from your mailbox. Connect it once, over IMAP with an app password (Gmail, iCloud, Yahoo, Fastmail, GMX or any other; Outlook and Microsoft 365 let apps in with OAuth only, which JobWarden doesn't have yet): JobWarden reads the last 30 days, then the new emails every ten minutes, read-only; in Settings → Inbox, you choose how often, from every 5 minutes to once a day, or only when you click Check now (InboxChecks looks every minute for the mailboxes whose time has come; jobwarden.inbox.tick). It tells a rejection, an interview, an offer or a confirmation that an application arrived from the email's words, in the app's languages, and the job from the company's name (in the email, or as the sender's domain) and the title; job alerts, and emails it isn't sure of, it leaves alone. Each becomes an update to apply to the job's timeline (dated when the email came, noting which email it was) or dismiss: nothing changes a job on its own. One that names none of your jobs, when it's clear news, waits for you to pick the job. Settings → Inbox also says what becomes of them: you review each (as by default); JobWarden applies those it matched to a job on its own, oldest first, noting the email's subject and sender; or, besides, it asks the assistant to sort the others (a SORT_INBOX request, one at a time, which the AI Assistant's loop picks up): the assistant reads each email's start (list_email_updates), finds its job with list_jobs, applies it (apply_email_update) or dismisses what isn't news (dismiss_email_update), and leaves what it isn't sure of for you. Ask the AI Assistant to sort them on the Inbox page asks it once, whatever the setting. What JobWarden and the assistant did on their own in the last two weeks shows under Done for you lately: an update applied links to its job, whose timeline event can be removed; one the assistant dismissed can be brought back. Proton Mail has no IMAP of its own: pick Proton Mail (Bridge), with Proton Mail Bridge open on the same computer (a paid Proton plan), and sign in with the password Bridge shows. JobWarden turns TLS on with STARTTLS when a server starts without it, as Bridge does, and never reads without TLS; Bridge signs its own certificate, so for a server on this computer JobWarden keeps the certificate it showed when connected and trusts only that one after (a Bridge reset means connecting again). The password is kept encrypted (AES-GCM, Secrets in common) with jobwarden.secret-key (the JOBWARDEN_SECRET_KEY environment variable; INBOX_SECRET_KEY and jobwarden.inbox.secret-key still count), or else a key file JobWarden makes in ~/.jobwarden/ (in Docker, keep it on a volume): losing the key means connecting again, and entering the GitHub token again. The inbox module: mail_accounts and email_updates.

Clone this wiki locally