Getting Started

Seekter is a free, open-source AI job search agent that runs inside Claude Code, on your own computer. Every working day it searches your job sources, filters the postings against your rules, auto-applies to the ones that fit by filling each employer's application form in your own Chrome, and keeps a markdown record of everything it did. This page takes you from nothing to your first run.

Before You Run It

Three things to know first:

• Every application goes out in your name, and you are responsible for what it says. Seekter never invents an answer it can't find in your profile, but you are the one sending it.
• Seekter never fills LinkedIn Easy Apply. Those postings come back to you as a list to send yourself. Reading LinkedIn is off by default; switching it on is against LinkedIn's terms and puts your account at risk.
• Seekter is free, running it is not. It runs in Claude Code, which needs a paid Claude plan or an Anthropic API account. A daily run reads many pages and fills many forms, so check what your plan covers.

The disclaimer has the details. Read it before your first run.

Install

You need Claude Code, Chrome with the Claude in Chrome extension, Node.js 20 or newer and your resume as a PDF. Then open a terminal where you want Seekter to live and run:

npx seekter init

Go into the new folder and open Claude Code there:

cd seekter

claude

That is all a job search needs. To pick the folder's name, install without a terminal command, or work on Seekter itself with git clone, see Install, which also explains the difference.

Set Up Your Profile

Inside Claude Code, run:

/seekter-init

It interviews you: about forty short questions, one at a time. Your contact details, the roles you're after, where you can work and under which visa, your salary bands, the sectors you won't touch, your standard answers to form questions, the facts free-text answers may draw on, and the searches to run. Near the end it shows you the job sites and the companies hiring remotely that fit where you live and the work you do, so you pick from a list instead of naming them from memory. It takes 20 to 30 minutes, and you can stop and pick up where you left off.

Have your resume file ready; it asks for the path and copies it into your profile. If you already keep a tracker in Notion, Airtable or Google Sheets, it can import a CSV export of it, so nothing you've applied to is applied to again.

Everything it writes goes into profile/, which is git-ignored: your personal details stay on your machine.

Your First Run

Before you start, open Chrome with the Claude in Chrome extension and log in to your webmail. If you've collected postings yourself, paste their links into the chat or put them in profile/links.txt; they are filled first. Then run:

/seekter-run

The run goes through your sources in a fixed order, drops the postings your rules rule out, checks every posting against your tracker so nothing is applied to twice, gives each one a fit score from 1 to 5 and opens the best fits first. The score only decides the order; nothing is thrown away because of it. It fills each form from your profile and stops for anything only you can decide.

At the end it writes a report: what it found in each source, what it applied to, what it passed over and why.

After the First Run

• Clear the "Needs you" list. The table at the top of applications/README.md lists everything waiting on you: a CAPTCHA, an account wall, a question only you can answer, each with its next step.
• Log replies. When a company answers, tell Seekter in a sentence ("Acme rejected me", "I have a call with Globex on Thursday") with /seekter-log, or ask it to sweep your inbox. See Tracking Replies.
• Read the report weekly. /seekter-report shows replies and interviews by source, title and fit score, and suggests at most two changes. Run /seekter-log before it, since the report reads your tracker, not your email. See Reading the Report.

From here on, /seekter-run is the one command you run every working day. The Daily Run explains what it does, and Setting Up Your Search how to tune it.