Skip to content

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.                              │
╰──────────────────────────────────────────────────────────────────────────────╯

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.                                  │
╰──────────────────────────────────────────────────────────────────────────────╯