Documentation
Examples
Common workflows, from a first run to going deep on a single job.
A daily run, start to finish
$ careeros dailyThe pipeline discovers across your enabled providers, deduplicates, applies hard constraints, gates, evaluates the survivors, thresholds into Apply and Consider tiers, writes resumes and cover letters for Apply-tier jobs, drafts application answers, renders a zero-cost report, and appends rows to your Sheet. Cached stages are reused silently.
Re-running the same day
If nothing changed, a re-run costs zero AI calls — every stage hits the cache. This is safe to do anytime, for example after fixing a credential.
$ careeros daily # unchanged inputs → all cache hitsPreparing for an interview
When a job becomes real, generate a deep report. It expands the existing evaluation with fresh company and role research — it never re-scores the job. It always publishes its output to Drive and your Sheet at the end.
$ careeros prep 3f2a9c1bApplying to a below-threshold job
Want to apply to a Consider-tier job, or one the batch couldn't read automatically? Draft its answers on demand, using your own logged-in browser or by pasting the questions.
$ careeros apply 3f2a9c1bVerifying a new provider before trusting it
Discovery ships with ats-dataset enabled by default today,
but the registry is built to run several sources side by side — see
providers/README.md's "Adding a provider" section. Before
wiring a new one into daily, force it in isolation and
inspect its real output shape.
$ careeros discover --provider my-provider --dry-run --limit 3 # shape check$ careeros discover --provider my-provider --limit 30 # real cost check