Job Signal finds companies that are hiring, from places you choose, and shows you the roles that fit you. You pick the few worth your time. It fills in the application form and helps you find who to write to. You send everything yourself.
It runs on your Mac. It is a little slow on purpose: a short list of roles you care about, not a flood of them.
Open Terminal (press Command and Space, type Terminal, press Return). Paste this line and press Return:
curl -fsSL https://raw.githubusercontent.com/alnaik/signals/main/scripts/install.sh | bash
Or, if you use Claude Code, paste this into it:
Set up Job Signal on my Mac from https://github.com/alnaik/signals: read its README, run its install line, and tell me when the board is open in my browser.
What happens next:
- It installs what Job Signal needs, if your Mac doesn't have it yet: Bun (what Job Signal runs on), Claude Code (one way to run the model) and a browser it reads careers pages with.
- It makes a folder for your data,
JobSignal, in your home folder. - It starts Job Signal in the background and opens it in your web browser.
- A first run of six short steps sets you up: about you, the model, a search provider, your signals, applying, and your positioning. Applying is where you add the Job Signal extension to Chrome; the app walks you through it. Only the first step is needed. Skip the rest and come back to them later.
- You land on Sources , which shows what is on and what to set up next.
The background reading starts once you finish the first run.
That is all you need to start. Updating, uninstalling and the developer commands come next; the rest of this page is for when you want to know more.
To update, paste the install line again. Your data folder is kept.
To uninstall, in Terminal:
cat ~/.jobsignal 2>/dev/null || echo ~/JobSignal # where your data folder is: note it first
~/.local/bin/jobsignal schedule uninstall # stop the board and the background check
rm -rf ~/.jobsignal-app ~/.local/bin/jobsignal ~/.jobsignal
The first line matters only if you moved your data folder at first run: ~/.jobsignal remembers
where it is, and the last line removes it. Then, if you want them gone too: delete that data folder
(your data), remove the keys in Keychain Access (search for "jobsignal"), remove the extension at
chrome://extensions, and delete the browser used to read pages, ~/Library/Caches/ms-playwright
(unless something else of yours uses Playwright). Bun and Claude Code stay installed.
Personal data lives in the data folder (default ~/JobSignal, or JOBSIGNAL_DATA), never in the
repo.
bun ci # install exactly what bun.lock says
bunx playwright install chromium # the browser the Apply and extension tests drive
bun run check # lint, typecheck, tests
bun bin/jobsignal.ts # list commands
- Signals come in. A signal is anything that says a company may be hiring: a post in Hacker News' monthly "Who is hiring" thread, a job alert email, a funding filing, a company you add yourself. You choose which sources are on, and you can add more over time.
- Companies are found. For each company a signal names, Job Signal finds its real website and its own job board.
- Roles appear. It reads each board about every 6 hours. Companies with roles that fit your title words and places go to yourInbox .
- You pick. On each role:Apply ,Apply + Watch (keep its new roles coming) orDismiss .
- The rest is on Signals. A company a signal named with nothing open that fits you is onSignals , with what named it and why it isn't in your Inbox: hiring, but nothing fits (near misses first: your title words in a place that isn't yours); nothing posted; or a careers page the app couldn't read.Work on any of them,Hide one from that list, orDismiss it. Companies that are likely noise (no website known, a fund, no signal on record) are folded away, never deleted.
- Apply fills the form. The form opens in Chrome, filled in from your profile, your earlier answers and your CV by the Job Signal extension: the PDF is attached, and its text file, if you add one, fills the work history and education. You check it and press Submit yourself.
- Work finds who to write to, if you want. It gathers public facts about the company, each with the exact words it came from, and writes a short brief: a problem the company has, the person who owns it, and something you could make for them. You write the message. It works on a company with no open role too: that is what Work on Signals is for.
Sources shows each source, whether it is on, and the steps to connect it:
Signals: the companies your sources named that have nothing open that fits you, and why:
Work on a company, with every line tied to the facts it rests on:
More: Getting started, the screens and what each button does · Sources, every source and how to connect it · How it works.
Everything runs on your Mac. The board is a web page that only your Mac can open (it listens on
127.0.0.1, never on your network). A background check runs every 15 minutes, and again when your
Mac wakes. Your data is one folder, ~/JobSignal: one database file, your profile and CVs, and
one folder per company you acted on. Keys and sign-ins are kept in the macOS Keychain, never in
that folder.
| Who | What they get | When |
|---|---|---|
| Companies' job boards and careers pages | A request for their public job list. Nothing about you. | About every 6 hours per board |
| Hacker News | A request for the public "Who is hiring" thread | Every 6 hours |
| The SEC | Your email address, because the SEC asks every reader of its filings for one | Nightly, if Funding filings is on |
| Anthropic (through Claude Code or your API key) | The text of posts, alert mails and careers pages to sort; for Work, the facts found about that company, your name, your positioning page and your list of evidence. Never your CV. | Only if you connect a model |
| The search provider you pick (Context.dev, Exa, Firecrawl or Parallel), and Hunter if you add it | Company names, websites and search words; for Work, the name of the person to find | Only if you add its key |
| GitHub, X, Gmail, a spare mailbox, feeds and fund job sites | Read-only requests to the accounts and addresses you connect | Only if you connect them |
The form filler in Chrome talks only to Job Signal on your Mac. Your CV goes only into the forms you open. Your north star, the sentence in the board's margin, never leaves your Mac.
Free with nothing connected: Hacker News, job boards, funding filings, files you drop in and companies you add. A Claude subscription runs the model at no extra cost; an Anthropic API key is paid per use. Each search provider has a free allowance. Paid lookups stop at a monthly limit you set ($5 to start). Details: docs/spend.md.
-
Nothing is sent for you. No form is submitted and no message is sent by Job Signal.
-
robots.txt is honoured. A site that asks not to be read is not read. Exceptions can only be added by you, in
config.toml, each with a reason. -
LinkedIn pages are never read , and it never applies on LinkedIn. LinkedIn job alerts come in as email.
-
A form for another company than the one you opened is not filled without asking. If the page moves on to another company's form, nothing goes in until you press Fill on the notice.
-
Voluntary questions are never answered for you : gender, race, veteran status, disability. Work authorisation and sponsorship are filled only from your own answers in Settings.
-
Keys stay in the Keychain. The bug report names a key only as set or not set.
-
Nothing on your own network is read. Every address, each redirect included, is checked to be a public one first. Known limit: outside the job board readers, a site's name is looked up once for the check and again for the request, so a site that switches its address between the two could get past it.
-
Every claim has a source. Each fact Work uses carries the exact quote from its page. A line that cites no fact is shown greyed.
-
A Mac (macOS). Job Signal runs on macOS only.
-
Git. If the installer says it is missing, run
xcode-select --installin Terminal, then the install line again. -
Bun and Claude Code: the installer adds them if they are missing.
-
Google Chrome, for the form filler. Without it, Apply still opens the form, just not filled in.
-
Optional: a Claude subscription or an Anthropic API key, for the model steps (sorting posts, reading some careers pages, Work). Without one, those steps wait and Sources says so.
The board shows Problems. Copy bug report copies a report you can paste into an issue or into Claude Code. It names keys only as set or not set and holds none of your profile.
- Getting started : first run, each screen, the commands
- How it works : from a signal to an application, the model's limits, where data lives, for contributors
- Sources : every source and how to connect it
- Spend : what each step costs and the limits
- Gmail : connecting Gmail for replies
- Intake rules : every rule from a signal to a role, in full
- Security ·Contributing
Job Signal is MIT licensed (LICENSE). It includes the job board readers of
career-ops (MIT, vendor/career-ops/LICENSE) and
the Geist fonts (SIL Open Font License, board/fonts/OFL.txt).