diff --git a/README.md b/README.md index 7e55246..b921f40 100644 --- a/README.md +++ b/README.md @@ -26,6 +26,12 @@ 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 yet (Workday, SuccessFactors, its own pages) is still a row, with that host and its slug there where one was found, shown under Companies as "not readable yet" with a link to its careers page, so the gap is visible and one parser 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.