CLI Reference¶
Auto-generated from kairos --help. Do not edit manually.
kairos¶
Usage: kairos [OPTIONS] COMMAND [ARGS]...
Kairos — find, score and track jobs across regions. Start with `kairos init`.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --install-completion Install completion for the current shell. │
│ --show-completion Show completion for the current shell, to copy │
│ it or customize the installation. │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ init Set up Kairos: profile, regions, resume, values, scoring, harvest; │
│ then a first run. │
│ generate Write application documents for a job from your base resume and │
│ evidence library: a tailored resume (default), a cover letter, a │
│ selection criteria │
│ response, or all of them. Every number and name must come from │
│ your own material or the │
│ ad. Each document is fitted to its page range, and one that cannot │
│ be fitted is not │
│ written (exit 3). An ad's --word-limit or --char-limit lifts the │
│ half-page minimum of the │
│ criteria response, never its one-page maximum. │
│ jobs Search and manage job listings. │
│ apps Applications: list them, see their timeline, record status │
│ changes, and review changes suggested by your mail. │
│ config View and manage Kairos configuration. │
│ resume Import and manage resumes. │
│ profile See and change what fit scores weigh. │
│ usage LLM token usage and cost, against your plan. │
│ skills Extract and manage your Skill Profile. │
│ evidence Your evidence library: checked stories that documents may cite. │
│ roles Role profiles: the kinds of role your general resumes target. │
│ report Telegram reports of the job pipeline: alerts and a daily digest. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos init¶
Usage: kairos init [OPTIONS]
Set up Kairos: profile, regions, resume, values, scoring, harvest; then a
first run.
Examples:
kairos init
kairos init --from onboarding.toml
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --from FILE Read every answer from a TOML file (see │
│ examples/onboarding.example.toml) │
│ --yes -y Update an existing config without asking │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos generate¶
Usage: kairos generate [OPTIONS] [JOB]
Write application documents for a job from your base resume and evidence
library: a tailored resume (default), a cover letter, a selection criteria
response, or all of them. Every number and name must come from your own
material or the ad. Each document is fitted to its page range, and one that
cannot be fitted is not written (exit 3). An ad's --word-limit or --char-limit
lifts the half-page minimum of the criteria response, never its one-page
maximum.
Page ranges: resume --pages 1: 0.5 - 1 page; resume --pages 2: 1.5 - 2 pages;
cover-letter: 0.5 - 1 page; criteria: 0.5 - 1 page.
With --role instead of a JOB it writes that role profile's general resume
(kairos roles).
For a job or a role, the roles and projects the target's skills do not show
are left out;
--keep and --drop overrule that by part of an entry's heading. With --pick you
see every
role, project and evidence story with its score first, and tick the ones to
use.
Example: kairos generate 5683ec14 --all --to "Vicky Q., Overseas Recruiting
Manager"
Example: kairos generate --role backend-engineer --language zh
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ job [JOB] Job id or its first characters; or use --role │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --role -r TEXT Write this role │
│ profile's general │
│ resume instead │
│ --keep TEXT Always show the role │
│ or project whose │
│ heading has this │
│ --drop TEXT Never show the role │
│ or project whose │
│ heading has this │
│ --doc -d TEXT Document to write, │
│ repeatable: resume, │
│ cover-letter, │
│ criteria or all │
│ --all -a Same as --doc all │
│ --pages INTEGER Resume length; │
│ default: the API's │
│ [resume] pages │
│ --intensity TEXT light, standard or │
│ strong; default: the │
│ API's config │
│ --from-tailored TEXT Reuse a tailored │
│ resume's id │
│ --to TEXT Addressee line, │
│ repeatable, e.g. │
│ "Vicky Q., │
│ Recruiter" │
│ --language TEXT en or zh; default: │
│ the API's config, │
│ else the resume's │
│ --note TEXT A fact of yours to │
│ work in; repeatable │
│ --work-rights [auto|state|omit] auto states it where │
│ you need sponsorship │
│ [default: auto] │
│ --format -f TEXT pdf or md; │
│ repeatable │
│ --out -o PATH Folder; default: │
│ this machine's │
│ [documents] out_dir │
│ --criteria-file FILE The ad's criteria, │
│ one per line; │
│ "(desirable)" marks │
│ a desirable one. │
│ Without it they are │
│ read from the ad │
│ --max-criteria INTEGER Read this many from │
│ the ad again; │
│ default: reuse the │
│ ones read before, │
│ else 5 │
│ --word-limit INTEGER Words per criterion │
│ set by the ad, │
│ followed exactly │
│ --char-limit INTEGER Characters per │
│ criterion set by an │
│ online form │
│ --pick Before writing, tick │
│ the roles, projects │
│ and stories to use; │
│ Enter keeps the │
│ proposal │
│ --preview --no-preview Print the text; │
│ write no files │
│ [default: │
│ no-preview] │
│ --force --no-force Write over an │
│ earlier run's files │
│ [default: no-force] │
│ --help Show this message │
│ and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos jobs¶
Usage: kairos jobs [OPTIONS] COMMAND [ARGS]...
Search and manage job listings.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ search Search for jobs across platforms. │
│ list List saved jobs with filters. │
│ check Ask each saved posting's site whether it is still open; │
│ archive closed ones. │
│ harvest Run every search in [jobs] harvest_* now and save what the │
│ boards return. │
│ size-employers Judge how big employers are, where you need visa │
│ sponsorship. │
│ score Score unscored postings against your base resume and │
│ [profile.fit]. │
│ view View detailed information for a single job. │
│ analyze Analyze a job's description and score it against your Skill │
│ Profile. │
│ analysis Show a job's stored analysis. │
│ gaps Which of the job's skills your base resume shows, quoting │
│ the line that shows it. │
│ Gaps are reported, never written into a resume. │
│ add Add a job you found yourself, from its link. Record applying │
│ with `kairos apps set`. │
│ apply Mark a job as applied (sets status and stamps the │
│ application time). │
│ status Update a job's tracking status. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos jobs search¶
Usage: kairos jobs search [OPTIONS] KEYWORDS
Search for jobs across platforms.
Use --interactive (-i) to pick country & region from a list,
or pass --country and --location directly.
Examples:
kairos jobs search "rust developer" -c AU -l Perth
kairos jobs search "python backend" -c AU -l Sydney --salary-min 120000
kairos jobs search "devops" -p seek,linkedin -d 7 -n 20
kairos jobs search "software engineer" -i
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * keywords TEXT Search keywords, e.g. 'rust developer' [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --country -c TEXT Region code: AU, HK, CN, ... (see │
│ /api/v1/regions) │
│ --location -l TEXT City within the region │
│ --interactive -i Interactively choose country & region │
│ --platforms -p TEXT Comma-separated: │
│ adzuna,seek,linkedin,jobtech,thehub,tenc… │
│ [default: adzuna] │
│ --salary-min INTEGER Minimum salary │
│ --job-type -t TEXT fulltime/parttime/contract │
│ --posted-within -d INTEGER Posted within N days [default: 14] │
│ --max-results -n INTEGER Max results to return [default: 50] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos jobs list¶
Usage: kairos jobs list [OPTIONS]
List saved jobs with filters.
Examples:
kairos jobs list
kairos jobs list --top
kairos jobs list --top --listed-sponsor
kairos jobs list --top --listed-sponsor --size small,medium
kairos jobs list -p adzuna -n 10
kairos jobs list -s new
kairos jobs list --cursor MjAyNi0wNC0w...
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --platform -p TEXT │
│ --status -s TEXT │
│ --cursor -c TEXT Pagination cursor │
│ --page-size -n INTEGER [default: 20] │
│ --top Best fit score first, with the reason │
│ --listed-sponsor Only employers on their region's official │
│ visa sponsor list │
│ --size TEXT Only employers of these sizes, │
│ comma-separated: small, medium, large, │
│ recruiter, unknown │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos jobs view¶
Usage: kairos jobs view [OPTIONS] JOB_ID
View detailed information for a single job.
Accepts a full UUID or a partial prefix.
Examples:
kairos jobs view 3f2a1b4c-...
kairos jobs view 3f2a1b4c
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * job_id TEXT Job UUID (partial OK) [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos jobs harvest¶
Usage: kairos jobs harvest [OPTIONS]
Run every search in [jobs] harvest_* now and save what the boards return.
The API also does this every [jobs] harvest_hours while it runs.
Example:
kairos jobs harvest
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos jobs score¶
Usage: kairos jobs score [OPTIONS]
Score unscored postings against your base resume and [profile.fit].
With --rescore, scores given before this command started are redone first,
oldest
first, so they follow your current weights; unscored postings come after them.
Examples:
kairos jobs score -n 50
kairos jobs score --rescore --all
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --limit -n INTEGER Most postings to score per batch [default: 30] │
│ --rescore Also redo existing scores, e.g. after changing │
│ weights │
│ --all Keep going in batches of --limit until nothing │
│ is left │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos jobs check¶
Usage: kairos jobs check [OPTIONS]
Ask each saved posting's site whether it is still open; archive closed ones.
Only postings you have not applied to are checked. The API also does this on
its own
every [jobs] availability_check_hours while it runs.
Example:
kairos jobs check
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --older-than FLOAT Skip postings checked within this many hours │
│ (0 = check all) │
│ [default: 0] │
│ --limit -n INTEGER Most postings to check [default: 100] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos jobs add¶
Usage: kairos jobs add [OPTIONS] URL
Add a job you found yourself, from its link. Record applying with `kairos apps
set`.
Example:
kairos jobs add https://example.com/apply -t "Software Engineer" -c Acme -l
Sydney
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * url TEXT The posting's link, or its application form [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ * --title -t TEXT [required] │
│ * --company -c TEXT [required] │
│ * --location -l TEXT [required] │
│ --country TEXT Region code, e.g. │
│ AU │
│ --description-file -d PATH Text file with the │
│ posting's │
│ description │
│ --salary-min INTEGER │
│ --salary-max INTEGER │
│ --sponsors-visa --no-visa-sponsor… Whether it │
│ sponsors visas │
│ --notes -m TEXT │
│ --status TEXT matched (default) │
│ or new │
│ [default: matched] │
│ --help Show this message │
│ and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos apps¶
Usage: kairos apps [OPTIONS] COMMAND [ARGS]...
Applications: list them, see their timeline, record status changes, and review
changes suggested by your mail.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ list Jobs you applied to, latest status change first. │
│ log The job's status timeline, oldest first. │
│ set Record a status change, e.g. `kairos apps set 3f2a interview --kind │
│ technical`. │
│ undo Undo the job's latest status change. The undone change stays in the │
│ timeline. │
│ sync Read new mail and add status suggestions for your applications. │
│ inbox Suggestions waiting for you, newest mail first. │
│ accept Record the suggested change in the job's timeline, dated when the │
│ mail arrived. │
│ ignore Dismiss a suggestion. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos apps list¶
Usage: kairos apps list [OPTIONS]
Jobs you applied to, latest status change first.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --status -s [new|analyzed|matched|skip │
│ ped|applied|in_review|asse │
│ ssment|interview|offer|rej │
│ ected|withdrawn] │
│ --page-size INTEGER RANGE [1<=x<=100] [default: 50] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos apps log¶
Usage: kairos apps log [OPTIONS] JOB_REF
The job's status timeline, oldest first.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * job_ref TEXT Job id, or its first characters as lists print it │
│ [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos apps set¶
Usage: kairos apps set [OPTIONS] JOB_REF STATUS:{new|analyzed|matched|skipped|
applied|in_review|assessment|interview|offer|rejected|w
ithdrawn}
Record a status change, e.g. `kairos apps set 3f2a interview --kind
technical`.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * job_ref TEXT Job id, or its first │
│ characters as lists print it │
│ [required] │
│ * status STATUS:{new|analyzed|matched The new status [required] │
│ |skipped|applied|in_review|a │
│ ssessment|interview|offer|re │
│ jected|withdrawn} │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --at TEXT When it happened: YYYY-MM-DD │
│ or ISO time; default now │
│ --note -m TEXT │
│ --kind [recruiter|technical|onsite| Interview round (status │
│ final] interview only) │
│ --agent Record the change as an │
│ agent's │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos apps undo¶
Usage: kairos apps undo [OPTIONS] JOB_REF
Undo the job's latest status change. The undone change stays in the timeline.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * job_ref TEXT Job id, or its first characters as lists print it │
│ [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --note -m TEXT │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos apps sync¶
Usage: kairos apps sync [OPTIONS]
Read new mail and add status suggestions for your applications.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --since TEXT Re-read from this date (YYYY-MM-DD) or ISO time │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos apps inbox¶
Usage: kairos apps inbox [OPTIONS]
Suggestions waiting for you, newest mail first.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --page-size INTEGER RANGE [1<=x<=100] [default: 50] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos apps accept¶
Usage: kairos apps accept [OPTIONS] SUGGESTION_REF
Record the suggested change in the job's timeline, dated when the mail
arrived.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * suggestion_ref TEXT Suggestion id or its first characters │
│ [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --job TEXT The job, when not the matched │
│ one (id or prefix) │
│ --status [new|analyzed|matched|skippe Record this instead of the │
│ d|applied|in_review|assessme suggestion │
│ nt|interview|offer|rejected| │
│ withdrawn] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos apps ignore¶
Usage: kairos apps ignore [OPTIONS] SUGGESTION_REF
Dismiss a suggestion.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * suggestion_ref TEXT Suggestion id or its first characters │
│ [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos evidence¶
Usage: kairos evidence [OPTIONS] COMMAND [ARGS]...
Your evidence library: checked stories that documents may cite.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ draft Draft stories from your base resume for the job's criteria that no │
│ story answers. │
│ drafts Drafts waiting for you, newest first. │
│ accept Append the draft to your evidence file, import the file, and mark │
│ the draft accepted. │
│ ignore Dismiss a draft. │
│ import Replace the library with a Markdown file of stories. │
│ list The stories as last imported; warns when the file has changed since. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos evidence import¶
Usage: kairos evidence import [OPTIONS] FILE
Replace the library with a Markdown file of stories.
Each story is a `## Title` followed by Tags:, Situation:, Action:, Result: and
Source: lines.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * file FILE [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos evidence list¶
Usage: kairos evidence list [OPTIONS]
The stories as last imported; warns when the file has changed since.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos evidence draft¶
Usage: kairos evidence draft [OPTIONS] JOB
Draft stories from your base resume for the job's criteria that no story
answers.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * job TEXT Job id or its first characters [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos evidence drafts¶
Usage: kairos evidence drafts [OPTIONS]
Drafts waiting for you, newest first.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos evidence accept¶
Usage: kairos evidence accept [OPTIONS] REF
Append the draft to your evidence file, import the file, and mark the draft
accepted.
Refuses when the file has changed since its last import, so an unsaved edit is
never
imported by accident: import it first, then accept.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * ref TEXT Draft id or its first characters [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --file PATH The evidence file; default the one last imported │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos evidence ignore¶
Usage: kairos evidence ignore [OPTIONS] REF
Dismiss a draft.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * ref TEXT Draft id or its first characters [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos roles¶
Usage: kairos roles [OPTIONS] COMMAND [ARGS]...
Role profiles: the kinds of role your general resumes target.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ build Build a role profile, or rebuild the one with the same name. │
│ list Every role profile. │
│ show A profile's skills, and which roles and projects its resume shows │
│ and why. │
│ edit Set which roles and projects this role's resume always or never │
│ shows. │
│ delete Delete a role profile and the resumes written for it. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos roles build¶
Usage: kairos roles build [OPTIONS] NAME
Build a role profile, or rebuild the one with the same name.
Skills are counted from the analyses of the saved jobs you choose: those whose
title
has the --title text and whose analysis names any --skill (each only when
given),
plus every --job. A skill at least half of them require is required, and one
at least
a quarter mention is preferred. At least 3 analysed jobs are needed.
Rebuilding keeps
the profile's keep and drop lists.
Keep one stack per profile. Run with --title backend --skill python to count
Python
backend jobs; the title alone mixes Java, Go and Python ads into a thin
profile.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * name TEXT The role, e.g. "Backend Engineer" [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --title TEXT Count saved jobs whose title contains this │
│ --skill TEXT Count only jobs whose analysis names this skill; │
│ repeatable (any of them) │
│ --job TEXT Count this saved job (id or its first │
│ characters); repeatable │
│ --skills-file FILE TOML with [[required]] and [[preferred]] skills, │
│ instead of counting jobs │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos roles list¶
Usage: kairos roles list [OPTIONS]
Every role profile.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos roles show¶
Usage: kairos roles show [OPTIONS] KEY
A profile's skills, and which roles and projects its resume shows and why.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * key TEXT Slug, id or its first characters [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos roles edit¶
Usage: kairos roles edit [OPTIONS] KEY
Set which roles and projects this role's resume always or never shows.
The lists you give replace the old ones; a list you leave out stays as it is.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * key TEXT Slug, id or its first characters [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --keep TEXT Always show entries whose heading has this; │
│ repeatable │
│ --drop TEXT Never show entries whose heading has this; │
│ repeatable │
│ --clear --no-clear Empty both lists first [default: no-clear] │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos roles delete¶
Usage: kairos roles delete [OPTIONS] KEY
Delete a role profile and the resumes written for it.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * key TEXT Slug, id or its first characters [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos report¶
Usage: kairos report [OPTIONS] COMMAND [ARGS]...
Telegram reports of the job pipeline: alerts and a daily digest.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ digest Send the daily digest now: the last 24 hours' postings and the │
│ pipeline's health. │
│ chat-id List the chats that messaged the bot, to find │
│ KAIROS_TELEGRAM_CHAT_ID. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos report digest¶
Usage: kairos report digest [OPTIONS]
Send the daily digest now: the last 24 hours' postings and the pipeline's
health.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos report chat-id¶
Usage: kairos report chat-id [OPTIONS]
List the chats that messaged the bot, to find KAIROS_TELEGRAM_CHAT_ID.
Send the bot any message first. Reads KAIROS_TELEGRAM_BOT_TOKEN from this
shell.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos profile¶
Usage: kairos profile [OPTIONS] COMMAND [ARGS]...
See and change what fit scores weigh.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ show Print your profile, preferred cities and fit weights. │
│ set Change fit weights: skills, industry, career_value, │
│ work_life_balance and │
│ foreign_companies take off, low, medium or high; industries, │
│ admired_employers, │
│ needs_sponsorship_in and foreign_companies_in take comma lists; │
│ sponsorship_offered_points and listed_sponsor_points take 0-50; │
│ notes takes text. │
│ cities Set the cities you want in a region (searches and fit scores use │
│ them). │
│ rules Scoring rules learned from the jobs you skip and apply to. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos profile show¶
Usage: kairos profile show [OPTIONS]
Print your profile, preferred cities and fit weights.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos profile set¶
Usage: kairos profile set [OPTIONS] PAIRS...
Change fit weights: skills, industry, career_value, work_life_balance and
foreign_companies take off, low, medium or high; industries,
admired_employers, needs_sponsorship_in and foreign_companies_in take comma
lists; sponsorship_offered_points and listed_sponsor_points take 0-50; notes
takes text.
Example:
kairos profile set work_life_balance=high industries=automotive,ERP
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * pairs PAIRS... KEY=VALUE, e.g. skills=high │
│ industries=ERP,automotive │
│ [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos profile cities¶
Usage: kairos profile cities [OPTIONS] REGION [CITIES]...
Set the cities you want in a region (searches and fit scores use them).
Examples:
kairos profile cities AU Sydney Melbourne
kairos profile cities CN 上海
kairos profile cities HK
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * region TEXT Region code, e.g. AU [required] │
│ cities [CITIES]... Cities to prefer; none = the whole region │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos profile rules¶
Usage: kairos profile rules [OPTIONS] COMMAND [ARGS]...
Scoring rules learned from the jobs you skip and apply to.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ retro Propose rules from the scored jobs you decided against their score: │
│ a good match │
│ you skipped, or a weak one you applied to. │
│ list Rules waiting for you and rules in use, newest first. │
│ accept Use a proposed rule in fit scores from the next scoring run on. │
│ ignore Dismiss a proposed rule. │
│ retire Take an accepted rule out of fit scoring. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos profile rules retro¶
Usage: kairos profile rules retro [OPTIONS]
Propose rules from the scored jobs you decided against their score: a good
match you skipped, or a weak one you applied to.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos profile rules list¶
Usage: kairos profile rules list [OPTIONS]
Rules waiting for you and rules in use, newest first.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --state [proposed|accepted|ignored|re One state; default proposed │
│ tired] and accepted │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos profile rules accept¶
Usage: kairos profile rules accept [OPTIONS] REF
Use a proposed rule in fit scores from the next scoring run on.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * ref TEXT Rule id or its first characters [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos profile rules ignore¶
Usage: kairos profile rules ignore [OPTIONS] REF
Dismiss a proposed rule.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * ref TEXT Rule id or its first characters [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos profile rules retire¶
Usage: kairos profile rules retire [OPTIONS] REF
Take an accepted rule out of fit scoring.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * ref TEXT Rule id or its first characters [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos usage¶
Usage: kairos usage [OPTIONS] COMMAND [ARGS]...
LLM token usage and cost, against your plan.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ plan Record how you pay for the LLM, for the comparison in `kairos usage`. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos usage plan¶
Usage: kairos usage plan [OPTIONS] CODE
Record how you pay for the LLM, for the comparison in `kairos usage`.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * code TEXT pro, max-5x, max-20x or api [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos resume¶
Usage: kairos resume [OPTIONS] COMMAND [ARGS]...
Import and manage resumes.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ import Import a Markdown resume as the base resume (the one fit scores │
│ use). │
│ list List saved resumes. │
│ delete Delete a resume. │
│ tailor Tailor your base resume to a job (synchronous; analyze the job │
│ first), then show │
│ its coverage of the job's skills, every change with its reason, and │
│ the claims an │
│ interviewer will ask about. │
│ report Show a tailored resume's coverage, changes with reasons, and claims │
│ to prepare. │
│ export Render a tailored resume to PDF, HTML or LaTeX and save it. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos resume import¶
Usage: kairos resume import [OPTIONS] PATH
Import a Markdown resume as the base resume (the one fit scores use).
Importing again makes the new file the base resume; earlier ones stay listed.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * path TEXT Path to a Markdown resume (.md) [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --title -t TEXT Defaults to the file name │
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos config¶
Usage: kairos config [OPTIONS] COMMAND [ARGS]...
View and manage Kairos configuration.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ view Display every setting, with secrets masked. │
│ set Set a configuration value using dot notation. │
│ path Show config file location. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos config view¶
Usage: kairos config view [OPTIONS]
Display every setting, with secrets masked.
Examples:
kairos config view
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos config set¶
Usage: kairos config set [OPTIONS] KEY VALUE
Set a configuration value using dot notation.
Examples:
kairos config set llm.model claude-sonnet-4-20250514
kairos config set search.platforms adzuna,seek,linkedin
kairos config set search.posted_within_days 7
kairos config set profile.target_roles "backend,fullstack,devops"
kairos config set jobs.harvest_keywords "backend engineer, 后端开发"
List settings take a comma list or a JSON list. The whole config is checked
before it is saved, so an invalid value never reaches the file.
╭─ Arguments ──────────────────────────────────────────────────────────────────╮
│ * key TEXT Config key (e.g. llm.model, adzuna.app_id) [required] │
│ * value TEXT Value to set [required] │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos config path¶
Usage: kairos config path [OPTIONS]
Show config file location.
Examples:
kairos config path
# ~/.config/kairos/config.toml
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯