Install
Install Seekter, the open-source AI job search agent for Claude Code: with npx seekter init, a zip download or git clone. What you need first, and what to run next.
Seekter is a folder of files: the commands Claude Code runs, the reference notes on job sources and application systems, the templates and the scripts. Installing it means putting that folder where you want your job search to live. There is no server, no account and nothing to compile.
What You Need
- Claude Code, on a paid Claude plan or an Anthropic API account.
- Chrome with the Claude in Chrome extension. Seekter fills forms in your own browser, with your own logins.
- Node.js 20 or newer. There are no packages and no
npm install; the scripts use Node alone. - Your resume, as a PDF. You can turn it into a master resume later.
Searching for Jobs, or Working on Seekter
There are two kinds of install, and the difference is what you plan to do with the folder:
| To search for jobs | To work on Seekter | |
|---|---|---|
| Use | npx seekter init, or the zip download | git clone |
| You get | The newest release, as plain files | The repository, with its git history |
| Updating | A new folder, then move your three folders across | git pull |
| Lessons your runs learn | Sent back as an issue, by hand | Sent back as a pull request with /seekter-git |
If you only want Seekter to run your job search, use npx seekter init: it is the shortest way in and nothing in it needs git. Clone the repository if you plan to change the commands, the reference notes or the scripts, or to send fixes back. You can switch to a clone later without losing your profile or your applications.
For Your Job Search
Into a New Seekter Folder
Open a terminal where you want Seekter to live and run:
npx seekter init
This puts the newest release in a new seekter folder. Go into it:
cd seekter
Then open Claude Code there:
claude
Into a Folder You Name
Add a name, and the folder is created if it doesn't exist:
npx seekter init my-job-search
Then cd my-job-search and run claude.
Into the Folder You're In
To put Seekter straight into the folder you're already in, with no seekter folder inside it, use a dot:
npx seekter init .
Then run claude in the same folder.
With a name or a dot, the folder has to be new or empty. If anything is already in it, init stops and touches nothing, so it can never write over your files.
By Downloading the Release
No command needed: download seekter.zip, the newest release, and unzip it where you want Seekter to live. Then open a terminal in the unzipped folder and run claude.
For Working on Seekter
By Cloning the Repository
Clone the repository, or your own fork of it:
git clone https://github.com/selfishprimate/seekter
Then cd seekter and run claude. A clone runs job searches exactly like the other installs; it just adds git, so git pull brings each release and /seekter-git sends what you change back as a pull request, after scanning it for your personal details.
What Comes Next
Inside Claude Code, run /seekter-init. It interviews you, writes your profile and your search, and shows you the job sites and companies that fit you. Getting Started walks through it and your first run.
Your profile, your applications and your run reports are git-ignored and stay in the folder you installed into. When a new version comes out, Updating Seekter shows how to move to it without touching them.