set_board sizes a board from page 1's total, or reads to the end on a host that states none, instead of reading it whole up to page 100. A pull no longer rewrites ats:size; a board with none is handed the agents' reach marked unsized and is sized in its batch first, or by its whole read on a host that cannot narrow the reach. reach.sizes drops the open-role fallback. The Companies line names countries a Workday or Oracle site does not list and a missing remote option. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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, Teamtailor, Workday, SuccessFactors, Oracle, Phenom, Eightfold and a dozen smaller hosts, one module each in plugins/readers/) 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 # 362 European employers from seed/companies.json, 175 with a readable board; a re-run adds new rows and boards
uv run app job pull # read every board and search, embed and score them, extract the best, rescore, summarise
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. node --test tests/js/*.test.mjs runs the chip input's. config.yaml is the committed default, with one starter agent and four Copenhagen searches on Jobindex; config.example.yaml documents every key, including the extract: and summarise: blocks, which set the default for the two model stages; the switch under Settings, Sources, Runs overrides it without a restart, and app stages does the same from the command line.
Sources: job boards and company boards
The Sources sub-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 discover "Pleo" pleo.io --add # find its board on its own site, then follow it
uv run app companies set-board lunar greenhouse:lunar # attach a board to a company, or replace the one it has
uv run app companies detach lunar # stop reading its board; the company stays
uv run app companies add "Revolut" --careers-url https://www.revolut.com/careers --reason blocked # one word: a company to read by hand
uv run app companies add greenhouse:lunar Lunar # two: a board and its company, which follows the company
uv run app companies by-hand # the companies read by hand, never opened first, with the Watchlist's rating
uv run app companies edit revolut --note "needs a login" # name, link, note or reason
uv run app companies checked revolut # its careers page was looked at just now; the Watchlist shows the date
uv run app companies remove revolut # refused while a board is on or it has open roles
The seed is a hand-picked list of European tech employers, not a list of boards: a company whose careers site runs on something the app cannot read (its own pages, a host with no module, a site whose robots.txt disallows reading) is still a row, with its careers page and the reason, shown on the Watchlist tab for checking by hand and under Companies as "not readable yet", so the gap is visible and one module at a time closes it. A row where nothing was found reads "board not found"; the "Not readable yet" filter shows both. Each row has a Set board control (Change once it has one) to attach, replace or detach its board by hand. Replacing or detaching closes the old board's open roles, and asks first when there are open roles to lose; a board is read once before it is kept, and one that lists no roles yet is kept too. Setting a board queues a pull right after, so its roles are read by the one already running or the very next one, rather than waiting for the schedule. companies discover reads a company's site for a link into one of the boards it knows, probes the hosts with a cheap per-slug endpoint only when no page names any host, and with --add sets the board of a new or existing company, or records the host it found when nothing readable was. A probe hit is a guess by name: check the roles it lists before trusting it for a common name.
A Jobindex query is its own syntax: words are OR, "a b" is a phrase, +word is required; --area 1 is Region Hovedstaden. A Platsbanken query is free text and --region the id of a län (CaRE_1nn_cSU is Skåne). 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, and asks first when there are open roles to lose; switching it back on, or saving a search, queues a pull right after, so the ones it still lists reopen without waiting for the schedule. The embeddings extra is what fit needs, agent is for extract on a model, passkeys for the Account tab's passkeys.
The tabs
Three tabs, and a cog for settings.
| Roles | newsdesk's feed: a filter rail (Show read, Best first or Newest first, first seen, tags, more filters), the open roles with company, place, age, tags and a summary, votes (▲ like ● neither way ▼ pass) and a Save button. A title opens the reader beside the list; on a phone it takes the screen. j/k move, Enter opens, / searches |
| Applications | the saved roles and their status, each change recorded as an event |
| Watchlist | the companies whose board the app cannot read, for going through their careers pages by hand: Yes or No marks whether one is worth checking (a filter shows the unrated, the yes, the no or all), the careers page opens in a new tab and notes when, and a missing or wrong link is set in the row. A company whose board is failing is listed too. Separate from the affinity a search agent has |
The cog opens /settings: a rail of pages on the left, the page beside it, sticky so Runs is one click away however long the company list gets. On a phone the rail is a strip under the header.
| Search agents | a card per agent, newest first: name, an On/Off switch, its prompts, its rules in words, and its weights. Edit turns the card into the form in place (name, prompts as rows, a Where block for the location rules, the other require/any/prefer rules as rows, weights); New agent puts a blank card on top. Saving or switching on rescores; deleting one takes its votes, liked companies and scores with it |
| Sources | one page showing one section at a time, picked in the rail or by the URL fragment: job boards (queries on Jobindex, Adzuna or Platsbanken: new, try, save, edit, remove), company boards (every company, its board or the host it cannot be read from, its open roles and its affinity for the picked agent, following a company, setting or changing a company's board) and runs (Run the pull now, what is running, the schedule, and the Problems log) |
| Account | the password, sessions and passkeys. Open on loopback, locked on anything else |
Likes, hidden companies and votes belong to a search agent, not to the account: two agents rank the same roles differently, and one may hide a company the other favours. An agent also learns from votes: its taste weight scores a role by how close it is to the roles the agent liked minus the ones it passed.
The reader, /roles/{uid}, shows the full posting: the same vote and Save controls, the company's own affinity, the tags and the summary when there is one. Opening a role marks it read, and so does a vote. A search role's posting is a teaser; the reader offers a Fetch button that scrapes the original listing once and stores the text. A Summarise button asks for a short summary of that one role; The switch under Settings, Sources, Runs (default from config.yaml's summarise: block) turns summarising on for the pull itself, bounded to the top roles of each agent by that agent's own limits so the cost stays flat.
Docs
docs/decisions.md: what was decided for roledesk and why.docs/open.md: what is left to do, for whoever picks this up next.desk/README.md,pipeline/README.md,auth/README.md,deploy/README.md: the copied modules, where each comes from and how to refresh it.docs/hosting.md,docs/release.md,docs/server.md,docs/password-protection.md,docs/llm-backends.md: the boilerplate's deployment docs.