WolfandClaude Fable 5.1 a5af47349f Pulls: Pull now on top, one stage at a time tucked away
Pull now moves from the Sources page's own button to Pulls, wired the same
way (POST /api/jobs {kind: "pull"}), sitting beside what is running. The
schedule follows, then extract, embed and score move under a "Run one
stage" details -- jobs.js still draws them from /api/jobs/kinds, minus
pull, which gets the dedicated button instead of appearing twice.

Messages' lede drops the file's own vocabulary (a "fix", "cleared yet") for
the reader's: a fortnight, not a job kind or a config key.

Found but not fixed: at 375px the refreshed desk-schedules still squeezes
its name and cadence columns to a sliver, because kind/next/last size to
their untruncated content instead of the width their own ellipsis implies.
No page-level horizontal scroll comes of it, so overflow-x: auto stays as
the safety net, with a comment pointing at the cause. The fix belongs in
../boilerplate, ahead of the next refresh -- out of reach from this
worktree.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-25 21:52:31 +02:00
2026-09-23 12:33:58 +02:00
2026-09-23 12:30:10 +02:00

roledesk

A job-search engine for one person. It reads the public job boards of the companies you follow (Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Recruitee, Personio) and runs saved searches on boards that span companies (Jobindex, Adzuna), keeps every posting with when it was first seen and when it closed, scores the open roles for each of your search agents, and tracks the applications you make.

Built on the boilerplate: its job queue and scheduler (pipeline/), password (auth/) and deploy kit (deploy/), plus the plugin contract and tools from news (desk/). FastAPI, Jinja2, SQLite, uv, no build step.

Quick start

uv sync --all-extras
uv run app companies seed      # 186 companies from seed/companies.json, one board each
uv run app job pull            # read every board and search, then extract, embed and score
uv run app serve               # http://127.0.0.1:8790

uv run app worker drains the queue without the web app, and uv run pytest runs the app's tests and the copied modules' own. config.yaml is the committed default, with three starter agents and four Copenhagen searches on Jobindex; config.example.yaml documents every key.

Searches and companies

The Sources tab does all of this; the same actions exist on the command line:

uv run app searches add jobindex "Copenhagen golang" --q "golang go-udvikler" --area 1
uv run app searches add adzuna "Berlin backend" --q backend --country de --where Berlin
uv run app searches list
uv run app companies prune --in DK,SE,NO,EU      # lists; add --apply to unsubscribe

A Jobindex query is its own syntax: words are OR, "a b" is a phrase, +word is required; --area 1 is Region Hovedstaden. An Adzuna search needs a free key from developer.adzuna.com in ADZUNA_APP_ID and ADZUNA_APP_KEY. searches add runs the search once and saves it only if it finds something. Switching a board or search off closes its open roles; the next pull after switching it back on reopens the ones it still lists. The embeddings extra is what fit needs, agent is for extract on a model, passkeys for the Account tab's passkeys.

The tabs

Roles open roles, newest or ordered by one agent's score, with filters, a Save button and each company's affinity
Applications the saved roles and their status, each change recorded as an event
Agents the search agents: intent, require and prefer gates, weights. Saving one rescores it
Companies every company whose board is read, its open roles, and its affinity: mute, neutral, like, favourite
Sources what a pull reads: saved searches (try, save, edit, remove), company boards (follow one, switch any on or off), and a prune of boards by region, with the countries each one's roles are in
Jobs a button per job (pull, extract, embed, score) and what is running
Schedules pull every 6h by default, editable in place
Messages everything the server said that nobody has cleared
Account the password, sessions and passkeys. Open on loopback, locked on anything else

Docs

S
Description
No description provided
Readme
4.6 MiB
0 Stars 1 Watchers 0 Forks
Languages
Python 85.3%
JavaScript 10.4%
CSS 2%
HTML 1.5%
PowerShell 0.5%
Other 0.3%