687fd5e91f
* feat(post-application): add schema and shared types for provider ingestion (#136) * test(orchestrator): ensure full localStorage shape in vitest setup * feat(post-application): add provider registry and dispatcher framework (#137) (#146) * Implement Gmail provider credential persistence (#147) * Add unified post-application provider action API (#148) * Implement Gmail ingestion sync with 95/60 relevance policy * Implement Gmail ingestion sync with 95/60 relevance policy (#149) * feat(post-application): add job mapping engine with llm rerank fallback * feat(post-application): add inbox review APIs with transactional approve/deny (#151) * feat(post-application): add tracking inbox UI with provider controls (#152) * oauth implementation * UI changes * see past runs in more detail * occurred at comes from email * state mismatch * better UI representation * comments * comments * comments * comments * documentation * explainer * set things manually * scrolling * any found email can be pending * searchable download * Email-to-Job Matching Decision Tree * email viewer list improvement * simplification initial commit * exclude discovered jobs * show only resady * dropdown * mermaid * syntax * targets is the same as logging that is done manually * event label * duplicate avoidance * clean up html * token saving * print * send idx not uuid * remove logging * formatting * better documentation * documentation * comments * process all * comments
JobOps
AI-powered job discovery and application pipeline. Automatically finds jobs, scores them against your profile, and generates tailored resumes.
Workflow
- Search: Scrapes Gradcracker, Indeed, LinkedIn, Glassdoor, and UK Visa Sponsorship jobs.
- Score: AI ranks jobs by suitability using the configured LLM provider (OpenRouter by default).
- Tailor: Generates a custom resume summary for top-tier matches.
- Export: Uses RxResume v4 to create tailored PDFs.
- Manage: Review and mark jobs as "Applied" via the dashboard (calls webhooks for lifecycle events).
- Track: Connect your Gmail to automatically track post-application emails (interviews, offers, rejections) via the Tracking Inbox. The Smart Router AI matches emails to your applied jobs and updates job application status automatically.
Example of generating a tailored resume for a job
https://github.com/user-attachments/assets/5b9157a9-13b0-4ec6-9bd2-a39dbc2b11c5
Example of applying to a Ready job
https://github.com/user-attachments/assets/06e5e782-47f5-42d0-8b28-b89102d7ea1b
How to Start
Prerequisites
- Docker Desktop (or Docker Engine + Docker Compose)
Overview
-
Run the app with Docker (this pulls the pre-built image).
-
Create accounts:
- OpenRouter (LLM scoring/tailoring)
- RxResume v4 (PDF export + editable resume data)
-
Open the dashboard and complete the onboarding wizard:
- Add API keys/credentials
- Choose a resume template from RxResume
- Run the pipeline to fetch jobs → score → tailor → export PDFs
-
Review jobs in the dashboard and mark stages
-
(Optional) Connect Gmail to enable automatic post-application email tracking
Post-Application Tracking (Optional)
Once you've applied to jobs, connect your Gmail account to automatically track responses:
- Go to Tracking Inbox in the dashboard
- Click Connect Gmail and authorize access
- The Smart Router AI will analyze incoming emails and match them to your applied jobs
- High-confidence matches (95%+) are auto-linked; others appear in your Inbox for review
- Interview invites, offers, and rejections automatically update your job timeline
See documentation/self-hosting.md for Gmail OAuth setup instructions.
Quick Start (commands)
# 1. Clone and move to directory
git clone https://github.com/DaKheera47/job-ops.git
cd job-ops
# 2. Start with Docker (pulls pre-built image from GHCR)
docker compose up -d
# 3. Open the dashboard in your browser, the app will onboard your credentials
# http://localhost:3005
Required accounts
-
OpenRouter (LLM provider)
- Create an account and generate an API key.
-
RxResume v4
- Create an account on v4.rxresu.me
- The summary, title, chosen projects, and keywords in the Resume will be tailored for the job description
- Recreate/import your resume there so JobOps can:
- pick a template
- generate tailored PDFs from your stored resume data
App Onboarding
The app will guide you through setup on first launch. The onboarding wizard helps you:
- Configure the LLM provider (OpenRouter by default) and add an API key if required (for AI scoring/tailoring)
- Add your RxResume credentials (for PDF export via v4.rxresu.me)
- Select a template resume from your v4.rxresu.me account
Technical Details
- Technical breakdowns here:
documentation/extractors/README.md - Orchestrator docs here:
documentation/orchestrator.md - Post-application tracking:
documentation/post-application-tracking.md - Full documentation index:
documentation/README.md - Persistent data lives in
./data(bind-mounted into the container).
Notes / sharp edges
- Crawl targets: edit
extractors/gradcracker/src/main.tsto change the Gradcracker location/role matrix. - Pipeline config knobs:
POST /api/pipeline/runaccepts{ topN, minSuitabilityScore };PIPELINE_TOP_N/PIPELINE_MIN_SCOREare used bynpm run pipeline:run(CLI runner). - Anti-bot reality: crawling is headless + "humanized", but sites can still block; expect occasional flakiness.
Note on Analytics: The current alpha version includes anonymous analytics (Umami) to help me debug performance. This will be made opt-in only in the upcoming updates. If you want to disable it now, block umami.dakheera47.com in your firewall.
Contact
If you need any help with any step of the process, feel free to open an issue. I am actively monitoring this section and I would be extremely happy to help you get up and running!
Star History
License
AGPLv3