How swiftkimani/kaziscout works
KaziScout is a local-first job-search agent: a user builds a profile, scans job sources, reviews and scores postings, then tracks applications and prepares materials while submitting applications themselves. The browser and terminal are documented entry points; this graph focuses on the browser-to-result path and the server services behind it. The README describes the provider, storage, scoring, and optional integrations; some subsystem details are unsampled, so only documented or indexed relationships are connected.
Main entry points: v1.ts HTTP routes · app.ts Service wiring · App.tsx Browser app · queries.ts API queries
Components 26
Web experience
- Browser app
web/src/App.tsx - Jobs and boards
web/src/features/jobs/JobsPage.tsx - Application tracker
web/src/features/tracker/TrackerPage.tsx - Profile and CV
web/src/features/profile/ProfileForm.tsx - API queries
web/src/api/queries.ts - API client
web/src/api/client.ts - Board directory
web/src/features/boards/BoardsPage.tsx - Markdown tool
web/src/features/extract/ExtractPage.tsx
HTTP application
- HTTP routes
server/src/routes/v1.ts - Service wiring
server/src/app.ts - SQLite database
server/src/db/client.ts
Job discovery
- Board scanning
server/src/services/scan.ts - Source registry
server/src/boards/registry.ts - Board providers
server/src/providers/index.ts - Jobs storage
server/src/repositories/jobs.ts
Profile and assessment
- CV import and profile
server/src/services/cv-import.ts - Job evaluation
server/src/services/evaluation.ts - Fit scoring
server/src/scoring/heuristic.ts - AI model client
server/src/ai/client.ts
Application tools
- Page to Markdown
server/src/services/markdown.ts - Application documents
server/src/services/documents.ts - Application assistance
server/src/services/apply.ts - Application tracking
server/src/repositories/applications.ts
Other components
- Job seeker
- Boards and employers
- Configured AI service
Connections 37
- Job seeker → Browser app: uses
web/src/App.tsx - Browser app → Jobs and boards: routes to
web/src/App.tsx - Browser app → Board directory: routes to
web/src/App.tsx - Browser app → Application tracker: routes to
web/src/App.tsx - Browser app → Profile and CV: routes to
web/src/App.tsx - Browser app → Markdown tool: routes to
web/src/App.tsx - Jobs and boards → API queries: requests data
web/src/api/queries.ts - Application tracker → API queries: requests data
web/src/api/queries.ts - Profile and CV → API queries: requests data
web/src/api/queries.ts - Board directory → API queries: requests data
web/src/api/queries.ts - Markdown tool → API queries: requests data
web/src/api/queries.ts - API queries → API client: calls
web/src/api/queries.ts - API client → HTTP routes: sends JSON
README.md - HTTP routes → Board scanning: dispatches
server/src/routes/v1.ts - HTTP routes → Job evaluation: dispatches
server/src/routes/v1.ts - HTTP routes → CV import and profile: dispatches
server/src/routes/v1.ts - HTTP routes → Page to Markdown: dispatches
server/src/routes/v1.ts - HTTP routes → Application documents: dispatches
server/src/routes/v1.ts - HTTP routes → Application assistance: dispatches
server/src/routes/v1.ts - Service wiring → HTTP routes: registers
server/src/app.ts - Service wiring → Board scanning: wires
server/src/app.ts - Service wiring → Job evaluation: wires
server/src/app.ts - Service wiring → Page to Markdown: wires
server/src/app.ts - Service wiring → Application documents: wires
server/src/app.ts - Service wiring → Application assistance: wires
server/src/app.ts - Board scanning → Source registry: uses sources
server/src/services/scan.ts - Board scanning → Board providers: dispatches scans
server/src/services/scan.ts - Board scanning → Jobs storage: stores postings
server/src/services/scan.ts - Board providers → Boards and employers: fetches postings
README.md - Job evaluation → Fit scoring: scores with
server/src/app.ts - Job evaluation → AI model client: optionally assesses
server/src/app.ts - AI model client → Configured AI service: requests assessment
README.md - Jobs storage → SQLite database: reads and writes
server/src/repositories/jobs.ts - Application tracking → SQLite database: reads and writes
server/src/repositories/applications.ts - HTTP routes → Application tracking: dispatches tracking
server/src/routes/v1.ts - Application assistance → Application tracking: records progress
- Job seeker → Boards and employers: chooses postings