job-auto-apply README

The project's README from github.com/Anshul439/job-auto-apply. As one markdown file: README.md.

job-auto-apply

Automates one-click job applications on Wellfound and Instahyre using Playwright. Runs locally in your own browser with your own session — no AI, no backend, completely free.

What it does

Requirements

Setup

pnpm install
pnpm exec playwright install chromium

Usage

Wellfound:

pnpm start:wellfound
  1. Browser opens — log in to Wellfound if needed
  2. Set your filters and navigate to your job results
  3. Press ENTER in the terminal
  4. Watch it go

Instahyre:

pnpm start:instahyre
  1. Browser opens and loads your saved Instahyre filter URL — log in if needed
  2. Update INSTAHYRE_JOBS_URL in src/instahyre/selectors.ts with your own filter URL
  3. Press ENTER when results are showing
  4. Watch it go

Your browser session is stored in ~/.wellfound-automation/browser-profile/ and reused on every run — no need to log in again after the first time.

Browser

Auto-detects in order: Brave → Chrome → Chromium, then falls back to Playwright's Chromium. Works on macOS, Linux, and Windows.

To use a custom browser path, set BROWSER_PATH in your .env:

BROWSER_PATH=/path/to/browser

Selectors

If a site updates its UI, that's the only file to touch.

job-auto-apply (Anshul439/job-auto-apply)

Searching Database…

273 ·GitHub
Job-auto-apply
What is this?A local automation script that auto-applies to jobs on Wellfound and Instahyre using Playwright, clicking through one-click applications in your own browser.
Is this a browser extension or a standalone script?It's a Node.js/TypeScript CLI script that drives a real browser (Brave/Chrome/Chromium) via Playwright — not a browser extension or hosted service.
How do I run it for Wellfound or Instahyre?Run the respective script (e.g. 'start:wellfound' or 'start:instahyre'), log in when the browser opens, set your filters/results page, then press ENTER in the terminal to let it start applying.
What do I need installed before running it?Node.js 18+, pnpm, and a Chromium-based browser (Brave, Chrome, or Chromium) — if none is found it falls back to Playwright's bundled Chromium.
What jobs does it skip instead of applying to?It skips jobs already applied to, external applications, listings with mandatory questions, and anything behind a CAPTCHA; it also leaves optional cover letter fields blank and takes a screenshot if something unexpected happens.
Does this work on any OS?Yes — it works on macOS, Linux, and Windows.
Where does my browser session and login data go?Your logged-in browser session is saved locally in a profile folder on your machine and reused on future runs, so you don't re-login each time.
Does it use AI to fill out applications?No — the README explicitly states there's no AI and no backend involved, it's purely browser automation via Playwright.
How do I point it at my own Instahyre search?Update the INSTAHYREJOBSURL constant in src/instahyre/selectors.ts with your saved filter URL from Instahyre.
What happens if Wellfound or Instahyre changes their site UI?Since all site-specific logic is isolated in selector files (src/wellfound/selectors.ts and src/instahyre/selectors.ts), only those files need updating if a site's UI changes.
Is this free to use?Yes, it's completely free with no backend or paid API required — it just automates your own browser session.
What are similar projects?webcmd, testsprite-cli, moli, mcp-chrome, lazy-frames, pinloop-cli, playwright-cli, atomic-agent
Which topics is it in?chatbot-framework, job-search, privacy-first, playwright, browser-automation, browser, local-first, productivity, command-line-tool, automation, nodejs, typescript
Creator
Anshul439
Size
0.1 MB
Stars
273
Updated
CommitOct 15
Age
1mo
Commits · 90 Days