AI-powered job search pipeline built on opencode. Evaluate offers, generate tailored CVs, scan portals, negotiate offers, and track everything -- powered by AI agents.
Paste a job URL. Get a scored evaluation, tailored CV, and tracked application — in seconds.
npx github:razroo/JobForge create-job-forge my-job-search
cd my-job-search
npm install
opencodeThe scaffolded opencode.json already has the Geometra MCP (browser automation + PDF) and Gmail MCP (reading replies) wired up — they launch automatically the first time opencode starts.
Then fill in cv.md, config/profile.yml, and portals.yml with your personal data, paste a job URL into opencode, and JobForge evaluates + tracks it.
Upgrade later: npm update job-forge && npx job-forge sync
Full setup guide and alternative install paths (including contributing to the harness itself): docs/SETUP.md.
JobForge turns opencode into a full job search command center. Instead of manually tracking applications in a spreadsheet, you get an AI-powered pipeline that:
- Evaluates offers with a unified 10-dimension weighted scoring system
- Generates tailored PDFs -- ATS-optimized CVs with anti-AI-detection writing rules
- Scans portals with fuzzy dedup (catches reposts with new URLs)
- Processes in batch -- evaluate 10+ offers in parallel with sub-agents
- Tracks everything with pipeline integrity checks and canonical state management
- Manages follow-ups -- timing-based nudges so you never miss a window
- Learns from rejections -- pattern analysis across all rejections by stage, archetype, and score
- Negotiates offers -- structured comp breakdown, leverage assessment, counter-offer strategy
Important: This is NOT a spray-and-pray tool. The whole point is to apply only where there's a real match. The scoring system helps you focus on high-fit opportunities instead of wasting everyone's time. Always review before submitting.
| Feature | Description |
|---|---|
| Auto-Pipeline | Paste a URL, get a full evaluation + PDF + tracker entry |
| Unified Scoring | 10 weighted dimensions, consistent across all modes, with calibration anchors |
| Anti-AI-Detection CVs | Writing rules that avoid ATS filters on Indeed, LinkedIn, Workday |
| 6-Block Evaluation | Role summary, CV match, level strategy, comp research, personalization, interview prep (STAR+R) |
| Interview Story Bank | Curated bank of 10-12 stories with match counts, archetype tags, and automatic pruning |
| Follow-Up System | Timing-based nudges: Applied 7+ days ago nudge, Interviewed 1 day ago thank-you note, email scanning via Gmail MCP |
| Gmail Integration | MCP server configured to retrieve emails for interview callbacks, offer responses, and application status updates |
| Rejection Analysis | Captures stage + reason, surfaces patterns (archetype gaps, scoring miscalibration) |
| Offer Negotiation | Total comp breakdown, equity valuation, leverage from pipeline, counter-offer scripts |
| Deep Research | Company research that feeds back into scores and interview prep |
| Smart LinkedIn Outreach | Reads evaluation reports to craft targeted messages using top proof points |
| Portal Scanner | 45+ companies pre-configured with fuzzy dedup for reposts |
| Batch Processing | Parallel evaluation with opencode run workers, with honest verification flagging |
| Pipeline Integrity | Automated merge, dedup, status normalization, health checks |
/job-forge → Show all available commands
/job-forge {paste a JD} → Full auto-pipeline (evaluate + PDF + tracker)
/job-forge scan → Scan portals for new offers
/job-forge pdf → Generate ATS-optimized CV
/job-forge batch → Batch evaluate multiple offers
/job-forge tracker → View application status
/job-forge apply → Fill application forms with AI
/job-forge pipeline → Process pending URLs
/job-forge contact → LinkedIn outreach (uses evaluation report)
/job-forge deep → Deep company research (feeds back into scores)
/job-forge followup → Check what needs follow-up action
/job-forge rejection → Record/analyze rejection patterns
/job-forge negotiation → Structured offer negotiation
/job-forge training → Evaluate a course/cert
/job-forge project → Evaluate a portfolio project
Or just paste a job URL or description directly -- JobForge auto-detects it and runs the full pipeline.
The system is designed to be customized by opencode itself. Modes, archetypes, scoring weights, negotiation scripts -- just ask opencode to change them: "Change the archetypes to backend engineering roles", "Add these 5 companies to portals.yml", "Update my profile with this CV I'm pasting".
You paste a job URL or description
│
▼
┌──────────────────┐
│ Archetype │ Classifies: LLMOps / Agentic / PM / SA / FDE / Transformation
│ Detection │
└────────┬─────────┘
│
┌────────▼─────────┐
│ A-F Evaluation │ Match, gaps, comp research, STAR stories
│ (reads cv.md) │ Unified 10-dimension scoring model
└────────┬─────────┘
│
┌────┼────┐
▼ ▼ ▼
Report PDF Tracker
.md .pdf .tsv
│
┌────┼────┐
▼ ▼ ▼
Apply Follow Negotiate
up (if offer)
Your personal project (after npx create-job-forge my-search):
my-search/
├── package.json # depends on "job-forge" (github:razroo/JobForge)
├── opencode.json # thin config — enables MCPs + states.yml
├── cv.md # your CV (personal)
├── article-digest.md # your proof points (optional, personal)
├── portals.yml # companies you want to scan (personal)
├── config/profile.yml # your identity, target roles (personal)
├── data/ # applications, pipeline, scan history (personal, gitignored)
├── reports/ # generated evaluation reports (personal, gitignored)
├── batch/
│ ├── batch-input.tsv # URLs to batch-evaluate (personal)
│ ├── batch-state.tsv # resumable batch state (personal)
│ ├── tracker-additions/ # TSVs waiting to merge (personal)
│ ├── logs/ # per-worker logs (personal, gitignored)
│ ├── batch-prompt.md # → symlink to node_modules/job-forge/
│ └── batch-runner.sh # → symlink to node_modules/job-forge/
├── modes/ # → symlink to node_modules/job-forge/modes/
├── templates/ # → symlink to node_modules/job-forge/templates/
├── .opencode/skills/job-forge.md # → symlink to node_modules/job-forge/
└── node_modules/job-forge/ # the harness (fetched from github:razroo/JobForge)
Symlinks are regenerated on every npm install via the package's postinstall hook. You never have to know about harness internals — just edit cv.md, portals.yml, and config/profile.yml.
The harness itself (this repo, what gets installed into node_modules/job-forge/):
JobForge/
├── package.json # bin: job-forge, create-job-forge
├── bin/
│ ├── job-forge.mjs # CLI dispatcher (merge/verify/pdf/tokens/sync/...)
│ ├── sync.mjs # postinstall: creates symlinks in consumer project
│ └── create-job-forge.mjs # npx create-job-forge scaffolder
├── .opencode/skills/job-forge.md # the skill router
├── modes/ # _shared.md + 16 skill modes
├── templates/ # cv-template.html, portals.example.yml, states.yml
├── config/profile.example.yml # template for consumer's profile.yml
├── batch/batch-prompt.md # batch worker prompt template
├── batch/batch-runner.sh # parallel orchestrator
├── scripts/token-usage-report.mjs # opencode cost analyzer
├── tracker-lib.mjs # shared tracker read/write helper
├── merge-tracker.mjs # merge batch TSVs → tracker
├── dedup-tracker.mjs # remove dupes
├── verify-pipeline.mjs # pipeline integrity checks
├── normalize-statuses.mjs # canonicalize status values
├── generate-pdf.mjs # CV PDF generator
├── cv-sync-check.mjs # setup lint
├── dashboard/ # optional Go TUI
├── fonts/ # Space Grotesk + DM Sans (for PDF)
└── docs/ # architecture, setup, customization
Index and cross-links: docs/README.md.
- Setup — both install paths, profile, CV, portals, verify, token tracking, troubleshooting
- Architecture — package architecture, modes, evaluation flow, batch runner, pipeline scripts
- Customization — archetypes, scanner keywords, CV template, states, customizing symlinked modes
- Contributing — branch workflow, quality gate, and ideas for PRs
MIT