Important:Read DISCLAIMER.md first.

Docs / Your Profile

Your Profile

The profile Seekter applies from: your standard answers to application questions, salary bands, location rules, fact bank and voice, and how to change a rule.

Everything Seekter knows about you lives in one file, profile/profile.md: your contact details, the standard answers to job application questions, salary bands, location and visa rules, and the facts your answers may draw on. /seekter-init writes it from your answers; every command reads it, and nothing personal is written anywhere else. It's plain markdown in a git-ignored folder, so you can open it and edit it whenever you like.

Its partner, profile/settings.json, holds the switches and numbers the search runs on. Setting Up Your Search covers that one.

What Each Section Does

SectionWhat it holdsWhere it's used
1. Identity and contactName and how it splits, the email forms get, phone formats, city, languages, linksEvery form's contact fields
2. DocumentsYour resume files and which one goes to which kind of roleEvery upload
3. Standard answersNotice period, work authorization, years of experience, how you heard, and the other questions forms keep askingEvery form
4. Salary bandsOne band per employer regionSalary fields, and the salary to name in an interview
5. Target rolesThe titles you apply for and the roles you rule outFiltering and the fit score
6. Location and work modelWhere you can work on-site, hybrid or remote, and where you'd relocateFiltering and the location tier
7. Blacklist and sensitive sectorsCompanies and sectors to never apply to, and sectors to ask about firstFiltering
8. Fact bankYour work history, the facts free text may draw on, and your storiesCover letters, free-text answers, interview prep, resume checks
9. VoiceHow you write, punctuation rules and banned phrasesEverything Seekter writes for you
10. Search configurationNotes on your searches and the decisions behind themThe daily run
11. TrackerHow applications are recordedLogging
12. Open itemsThings only you can do: a CAPTCHA, an account, a declarationA list Seekter keeps for you

Anything marked ASK is unknown on purpose: a form that needs it stops and asks you instead of guessing.

Standard Answers

Forms ask the same twenty questions in different words. Section 3 answers them once. A question your profile can't answer is never guessed: an optional field stays blank, and a required one turns the form into a hand-off with that one question for you. Your answer then goes into the table, so the next form doesn't ask.

Some answers are never filled from anywhere but your own words: date of birth, current salary, demographic questions, team sizes, metrics, and "tell us about a time…" stories.

The Fact Bank

Section 8 is what keeps free text true. A cover letter or a free-text answer may only state what's here, and every one is checked before it goes into a form: a number that isn't in your facts, a phrase you banned, or a sentence already sent to another company is caught and rewritten.

  • Facts, not phrases. Write what you did, with the product, the number and the tools. Seekter writes a new sentence for each company from those facts; no sentence goes to two companies.
  • Numbers only you can vouch for. A number in the fact bank will appear in applications. If you aren't sure of one, leave it out.
  • Stories in your own words. "Tell us about a time…" answers and interview prep use only the stories you wrote down. Longer ones can live in their own file, by default profile/interviews/README.md; name it in the fact bank by path and its numbers count as facts too.

Voice

Section 9 is how you sound: the register, the punctuation you use and the phrases you never want to see under your name. The banned phrases are checked mechanically before every free-text answer, every resume print and every interview prep.

Teaching It a Rule

You don't have to edit the file to change how Seekter behaves. When a run makes a call you disagree with, say so in the chat:

  • "A lead role with one or two reports is fine."
  • "Never apply to Initech."
  • "For the notice period, say immediately."

The rule goes into profile/profile.md in your own words, with the date, and every later run follows it. Reading the file now and then is the quickest way to see everything Seekter believes about you.

Starting Over or Updating

Run /seekter-init again at any time. It asks whether to update the profile section by section or start over, and keeps a copy of the old one if you start over.

Updated October 22, 2026.