Overview¶
The Problem¶
Applying for jobs is repetitive and time-consuming:
- Search across multiple platforms (Seek, Indeed, LinkedIn)
- Read each JD and decide if it's a good fit
- Customize your resume for each application
- Submit the application
- Track everything in a spreadsheet
Kairos automates steps 1-4 and replaces the spreadsheet with a proper tracking system.
How It Works¶
flowchart TD
A[Configure Profile + Import Resume] --> B[Search across platforms]
B --> C[Analyze JDs with Claude AI]
C --> D[Tailor resume per JD]
D --> E[Review diff + Approve]
E --> F[Browser opens → You submit]
F --> G[Track in Dashboard]
Access It Your Way¶
The core workflow is the same regardless of how you access Kairos:
flowchart LR
CLI[CLI] --> API[Kairos API]
Web[Web App] --> API
API --> Engine["Core Engine\n(search + analyze + tailor + track)"]
| Frontend | Best For | Status |
|---|---|---|
| CLI | Power users, scripting, automation | Shipped |
| Web App | Browser access, mobile-friendly, sharing | Search slice shipped (React 19 + Vite) |
Target Platforms¶
| Platform | Region | Method | Status |
|---|---|---|---|
| Adzuna API | AU, US, UK, CA, NZ +14 more | Free HTTP API (structured JSON) | Shipped — primary source |
| Seek.com.au | Australia, NZ | HTTP scraping (httpx + bs4) | Shipped — fallback |
| Global | Public guest API (httpx + bs4) | Shipped — fallback | |
| ~~Indeed~~ | ~~AU, US, UK, CA~~ | ~~Headless browser (playwright)~~ | Deferred — Cloudflare ban risk |