CLI Reference¶
Auto-generated from kairos --help. Do not edit manually.
kairos¶
Usage: kairos [OPTIONS] COMMAND [ARGS]...
Kairos — automated job application workflow for the Australian market.
╭─ 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 First-time setup — interactive wizard for API keys and preferences. │
│ jobs Search and manage job listings. │
│ config View and manage Kairos configuration. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos init¶
Usage: kairos init [OPTIONS]
First-time setup — interactive wizard for API keys and preferences.
Walks through 6 steps: profile, database, Adzuna API,
LLM model, API server, and search defaults.
Examples:
kairos init
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --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. │
│ view View detailed information for a single job. │
╰──────────────────────────────────────────────────────────────────────────────╯
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 Country: AU, US, UK, CA, NZ │
│ --location -l TEXT Region/city name from predefined list │
│ --interactive -i Interactively choose country & region │
│ --platforms -p TEXT Comma-separated: adzuna,seek,linkedin │
│ [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 -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] │
│ --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 config¶
Usage: kairos config [OPTIONS] COMMAND [ARGS]...
View and manage Kairos configuration.
╭─ Options ────────────────────────────────────────────────────────────────────╮
│ --help Show this message and exit. │
╰──────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ───────────────────────────────────────────────────────────────────╮
│ view Display current configuration. │
│ set Set a configuration value using dot notation. │
│ path Show config file location. │
╰──────────────────────────────────────────────────────────────────────────────╯
kairos config view¶
Usage: kairos config view [OPTIONS]
Display current configuration.
Shows all settings with sensitive values 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"
╭─ 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. │
╰──────────────────────────────────────────────────────────────────────────────╯