Skip to content

What the Screens Ask the Brain (Plain Language)

WorkWingman has a brain (a small program running on your own computer) and a set of screens you click through. Every time you use a screen, it quietly asks the brain a question or gives it an instruction. This page translates those behind-the-scenes conversations into plain English, screen by screen.

You don't need to know any of this to use the app — it's just here so the app feels less like a black box. There's no computer jargon below; if you want the exact technical details, see the technical version.

One promise worth repeating up front: the brain never hands your passwords to the screens. Even the "vault" screen only ever sees labels like "your Workday account" — never the actual password. The part of the app that fills forms reaches for the real secret quietly, only at the moment it's needed.

Job queue

"Show me my saved jobs, oldest first." · "Tell me more about this one." · "Go check LinkedIn for anything new I saved."

The queue screen asks the brain for your list of saved jobs (oldest first, so nothing gets forgotten), for the full details of any one job you click, and — when you hit refresh — to go pull in any new jobs you've saved on LinkedIn.

Live run (watching an application get filled)

"Start applying to this job." · "Pause." · "Resume." · "Stop." · "I'll answer that — here's my choice."

This is the watch-it-happen screen. It tells the brain to start filling out an application, and lets you pause, resume, or stop at any time. When the brain isn't sure about a field, it stops and asks you; you pick from a short ranked list, and this screen sends your answer back. The brain remembers your choice so it won't ask again next time.

Documents (resume + cover letter)

"Show me the tailored resume and cover letter for this job." · "Write them." · "Try again." · "These look good — approved."

The documents screen asks the brain to show, create, or re-do the resume and cover letter tailored to a specific job, and lets you give the final thumbs-up before they're used anywhere.

Study

"Give me a study plan for this role." · "Set up a Claude study project for it." · "Sign me up for this course."

The study screen asks the brain for prep material matched to the job, can spin up a dedicated Claude study workspace, and can enroll you in a course through an account you've linked.

Your profile and your story

"Show me the answers I gave once." · "Save these updated answers." · "Show my story and writing voice." · "Save my story."

These screens hold the answers you fill in once — your contact details, work history, eligibility, and the deeper "your story" background that helps the brain write cover letters that actually sound like you. The screens ask the brain to show what's saved and to save your edits.

Know yourself (optional self-assessment)

"Show me my self-assessment." · "Score my Big Five answers." · "Save my self-entered type." "Save my work/communication/learning style." · "Show me free tests I can take elsewhere." "Export this to Google Forms" (the one request that leaves your machine).

Everything here stays local except the one explicit export request. See self-assessment.md for the full picture.

Applied (tracking)

"List everyone I've applied to." · "Show my upcoming interviews." · "Update this one's status." · "Check my email for new interview invites and put them on my calendars."

The applied screen asks the brain for your application history and upcoming interviews, lets you update where each one stands, and can scan your email for interview invites and add them to your Google and Apple calendars.

Connections and settings

"Which of my accounts are linked, and how are they doing?" · "Show my automation settings." · "Save these settings."

The connections screen asks the brain about your linked accounts (LinkedIn, Google, the vault, and so on) and their status. The settings screen shows and saves your preferences — like how confident the brain has to be before it fills something in without asking. One setting can't be turned off, on purpose: nothing is ever submitted without your review.

The vault (your passwords)

"Is the vault unlocked?" · "Unlock it." · "List what's stored — just the labels."

The vault screen asks whether your password vault is unlocked, unlocks it when you say so, and lists what's inside — but only the labels, like "LinkedIn login" or "Workday account." The actual passwords never leave the vault.

The health check (dependencies)

"Check whether everything I need is installed." · "Please install these ones I approved."

On first launch, the health-check screen asks the brain to look over the extra tools the app needs and report what's missing or out of date. If you approve some to be installed, it sends back just the ones you approved — never a blanket "install everything." This install step is specially protected so that only the real app (not some random web page) can trigger it.