How qwikchoice/career-os works
Career OS is a local-first job-search system of record. Users enter roles and free-text updates through the CLI or localhost web UI; the service layer classifies and resolves them, records application, referral, interview and evidence activity, and presents actions, pipeline, dossier and dashboard results. SQLite and retained raw sources underpin those stages. The graph preserves the README’s major capabilities; some links rely on README or source-index references rather than inspected implementations, so unsampled connections are omitted.
Main entry points: cli.py CLI · dossier.py Role dossier · roles.py Role intake · server.py Local web server
Components 26
User interfaces
- CLI
cli.py - Local web server
server.py - Web interface
static/index.html
Search workflow
- Role intake
src/career_os/services/roles.py - Role classifier
src/career_os/classify.py - Offline heuristics
src/career_os/heuristics.py - Applications
src/career_os/services/applications.py - Contacts
src/career_os/services/contacts.py - Referrals
src/career_os/services/referrals.py - Interviews
src/career_os/services/interviews.py - Interactions
src/career_os/services/interactions.py - Job sources
src/career_os/services/job_sources.py - Inference claims
src/career_os/services/claims.py - Problem shape
src/career_os/services/problem_shape.py - Career skills
src/career_os/services/skills.py - Career evidence
src/career_os/services/evidence.py
Planning and insight
- Learning plans
src/career_os/services/learning.py - Pipeline view
src/career_os/services/pipeline.py - Action center
src/career_os/services/actions.py - Dashboard metrics
src/career_os/services/metrics.py - Weekly review
src/career_os/services/review.py - Role dossier
src/career_os/services/dossier.py - Data export
src/career_os/services/export.py
Local records
- Raw sources
src/career_os/services/sources.py - SQLite database
src/career_os/db.py
Other components
- Job seeker
Connections 45
- Job seeker → CLI: runs commands
README.md - Job seeker → Web interface: uses browser
README.md - Web interface → Local web server: sends updates
README.md - Local web server → Dashboard metrics: computes metrics
server.py - Local web server → Role dossier: loads dossier
server.py - Local web server → SQLite database: opens connection
server.py - Local web server → CLI
cli.py - CLI → Role intake: adds roles
README.md - CLI → Applications: updates status
README.md - CLI → Action center: lists actions
cli.py - CLI → Pipeline view: shows pipeline
cli.py - CLI → Dashboard metrics: shows metrics
cli.py - CLI → Role dossier: shows dossier
cli.py - CLI → Data export: exports data
cli.py - CLI → Learning plans: manages learning
cli.py - Role intake → Role classifier: classifies roles
src/career_os/services/roles.py - Role classifier → Offline heuristics: uses fallback
src/career_os/classify.py - Role intake → Job sources: resolves source
src/career_os/services/roles.py - Role intake → Raw sources: retains posting
src/career_os/services/roles.py - Role intake → Applications: creates application
src/career_os/services/roles.py - Problem shape → Inference claims: records inferences
src/career_os/services/problem_shape.py - Problem shape → Career skills: uses skills
src/career_os/services/problem_shape.py - Career evidence → Career skills: links evidence
src/career_os/services/evidence.py - Learning plans → Problem shape: uses analysis
src/career_os/services/learning.py - Learning plans → Role intake: reads role
src/career_os/services/learning.py - Learning plans → Career skills: checks coverage
src/career_os/services/learning.py - Referrals → Contacts: resolves contacts
src/career_os/services/referrals.py - Referrals → Applications: updates application
src/career_os/services/referrals.py - Referrals → Interactions: logs interaction
README.md - Pipeline view → SQLite database: queries records
src/career_os/services/pipeline.py - Dashboard metrics → Pipeline view: uses role facts
src/career_os/services/metrics.py - Action center → Dashboard metrics: uses metrics
src/career_os/services/actions.py - Action center → Pipeline view: checks pipeline
src/career_os/services/actions.py - Role dossier → Applications: reads application
src/career_os/services/dossier.py - Role dossier → Inference claims: reads claims
src/career_os/services/dossier.py - Role dossier → Interactions: reads activity
src/career_os/services/dossier.py - Role dossier → Interviews: reads interviews
src/career_os/services/dossier.py - Role dossier → Problem shape: reads analysis
src/career_os/services/dossier.py - Role dossier → Role intake: reads role
src/career_os/services/dossier.py - Role dossier → Career skills: reads skills
src/career_os/services/dossier.py - Data export → Dashboard metrics: uses metrics
src/career_os/services/export.py - Data export → Pipeline view: uses pipeline
src/career_os/services/export.py - Data export → Role intake: reads roles
src/career_os/services/export.py - CLI → SQLite database: initializes store
README.md - Raw sources → SQLite database: stores source records
src/career_os/services/sources.py