Documentation
Overview
CareerOS finds jobs, scores them against your real experience, and writes the results into a Google Sheet you open every morning.
CareerOS is an AI-powered, deterministic job discovery and recommendation engine. It is not an application bot. It sources roles, filters and scores them, and drafts the artifacts you need — but you stay in the loop and do the applying.
The whole system is built around one rule: use deterministic code wherever possible, and AI only where reasoning genuinely adds value. Discovery, deduplication, thresholding, and the daily report are plain code that costs zero tokens. AI is spent on exactly two things that need judgment: a cheap triage gate, and one real evaluation per job that survives it.
The shape of a day
$ careeros daily # discover, score, draft, and fill your Sheet # → discovered 84 jobs across 3 providers# → 61 unique after dedupe# → 47 passed hard constraints# → 12 kept by the gate# → 12 evaluated (7 from cache)# → 3 Apply, 4 Consider, written to your SheetThe numbers above illustrate the funnel; your run's counts will differ. You open the Sheet, read the score and one-line reason for each job, and start applying to the ones worth your time.