# JobForge > AI-powered job search automation — evaluate offers, generate ATS-optimized CVs, scan portals, negotiate, and track applications. One config drives OpenCode, Cursor, Claude Code, and Codex. Free end-to-end via OpenCode + Geometra MCP. - **Type:** MCP server - **Install:** `agentstack add mcp-agent-pattern-labs-jobforge` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [Agent-Pattern-Labs](https://agentstack.voostack.com/s/agent-pattern-labs) - **Installs:** 0 - **Category:** [Search](https://agentstack.voostack.com/c/search) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [Agent-Pattern-Labs](https://github.com/Agent-Pattern-Labs) - **Source:** https://github.com/Agent-Pattern-Labs/JobForge - **Website:** https://www.npmjs.com/package/job-forge ## Install ```sh agentstack add mcp-agent-pattern-labs-jobforge ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # JobForge > AI-powered job search pipeline for opencode: evaluate roles, generate tailored CV PDFs, scan portals, apply to good-fit jobs, and track the whole search locally. Paste a job URL. Get a scored evaluation, tailored CV, and tracker entry. ## Start Here Most users should scaffold a personal job-search project instead of cloning this harness repo directly. ### Prerequisites - [opencode](https://opencode.ai) installed and configured - Node.js 20.6 or newer - Optional: Go, only if you want to build the dashboard TUI ### Create Your Project ```bash npx --package=job-forge create-job-forge my-job-search cd my-job-search npm install ``` Then edit the three personal files the scaffolder creates: | File | What to put there | |------|-------------------| | `cv.md` | Your CV in markdown. This is the source for matching and PDF generation. | | `config/profile.yml` | Your identity, target roles, location constraints, compensation, and proof points. | | `portals.yml` | Companies, search queries, and title filters for portal scanning. | Optional: add `article-digest.md` with portfolio links, case studies, or extra proof points. ### First Run ```bash npx job-forge sync-check opencode ``` Inside opencode, paste a job URL or job description. JobForge routes it through the auto-pipeline: evaluation, score, tailored report, PDF, and tracker update. To see the command menu: ```text /job-forge ``` ## What It Does JobForge is built for selective, high-fit applications. It is not intended for spray-and-pray submission. - Scores opportunities with a consistent weighted rubric. - Generates tailored ATS-friendly CV PDFs. - Scans configured company portals and job boards. - Tracks applications, follow-ups, rejections, offers, reports, and PDFs. - Supports batch evaluation and application work through bounded subagents. - Uses local helper CLIs for dedupe, scoring, lineage, preflight, postflight, receipts, and tracker integrity. ## Common Commands Run these from your personal project root after `npm install`. | Need | Command | |------|---------| | Verify setup after editing profile and CV | `npx job-forge sync-check` | | Check tracker and pipeline health | `npx job-forge verify` | | Merge batch tracker additions | `npx job-forge merge` | | Generate a CV PDF from the current project | `npx job-forge pdf` | | Show token usage | `npx job-forge tokens --days 1` | | Create a verifiable evidence receipt | `npx job-forge receipts:create --artifact ` | | Rebuild harness symlinks | `npx job-forge sync` | | Upgrade the harness | `npm run update-harness` | Useful opencode commands: | Need | Command | |------|---------| | Evaluate a pasted URL or JD | Paste it directly, or use `/job-forge` | | Scan configured portals | `/job-forge scan` | | Process queued URLs | `/job-forge pipeline` | | Batch evaluate roles | `/job-forge batch` | | Fill an application form | `/job-forge apply` | | Check application status | `/job-forge tracker` | | Check due follow-ups | `/job-forge followup` | | Draft LinkedIn outreach | `/job-forge contact` | | Research a company | `/job-forge deep` | | Handle rejection or offer workflows | `/job-forge rejection` or `/job-forge negotiation` | ## How The Flow Works ```text Paste a job URL or JD | v Extract role details and classify fit | v Score against profile, CV, location, comp, and role goals | v Create report + tailored PDF + tracker entry | v Apply, follow up, research, or negotiate from the tracked state ``` ## Project Layout A scaffolded personal project looks like this: ```text my-job-search/ ├── package.json # depends on job-forge from npm ├── opencode.json # MCP and opencode configuration ├── cv.md # personal, gitignored ├── article-digest.md # optional personal proof points, gitignored ├── config/profile.yml # personal, gitignored ├── portals.yml # personal scanner config, gitignored ├── data/ # pipeline, applications, scan history ├── reports/ # generated evaluations ├── output/ # generated PDFs ├── batch/tracker-additions/ # batch apply/eval results before merge ├── AGENTS.md # personal overrides ├── AGENTS.harness.md # symlink into node_modules/job-forge ├── modes/ # symlinked JobForge modes ├── templates/ # symlinked policies and templates └── node_modules/job-forge/ # the harness package ``` Your personal files and generated job-search state are gitignored by the scaffolded project. ## MCPs And Automation The scaffolded opencode project wires up the browser and mail automation JobForge needs: - Geometra MCP for browser automation and PDF generation. - Gmail MCP for recruiter replies, interview callbacks, offer responses, and status emails. The harness also ships config for Cursor, Claude Code, and Codex through generated symlinks. `npm install` and `npx job-forge sync` refresh those links. ## Contributor Setup Clone this repo directly only when you want to work on the harness itself: modes, scripts, templates, generated agent configs, or release packaging. ```bash git clone https://github.com/Agent-Pattern-Labs/JobForge.git cd JobForge npm install npm run build:config npm run verify ``` The source of truth for generated harness configuration is under `iso/`. Run `npm run build:config` after changing `iso/` files. ## Documentation - [Setup](docs/SETUP.md) - full install paths, personalization, tracker setup, token tracking, troubleshooting. - [Architecture](docs/ARCHITECTURE.md) - consumer vs harness split, modes, scripts, batch flow, generated config. - [Customization](docs/CUSTOMIZATION.md) - profile, archetypes, scanner keywords, states, templates, local overrides. - [Model Routing](docs/MODEL-ROUTING.md) - subagent tiers and how to change model routing. - [Examples](examples/README.md) - fictional CVs, sample JD, and sample report. - [Batch Runner](batch/README.md) - TSV format, durable batch runner, merge flow. - [Contributing](CONTRIBUTING.md) - branch workflow and quality checks. ## Troubleshooting `sync-check` fails before your CV/profile are complete. That is expected until `cv.md` and `config/profile.yml` are filled in. If symlinks look stale after moving a project, run: ```bash npx job-forge sync ``` If PDF or browser automation fails, start with: ```bash opencode mcp list ``` Then see [docs/SETUP.md](docs/SETUP.md#troubleshooting) for Geometra, Gmail, dashboard, tracker, and merge troubleshooting. ## License MIT ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [Agent-Pattern-Labs](https://github.com/Agent-Pattern-Labs) - **Source:** [Agent-Pattern-Labs/JobForge](https://github.com/Agent-Pattern-Labs/JobForge) - **License:** MIT - **Homepage:** https://www.npmjs.com/package/job-forge Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-agent-pattern-labs-jobforge - Seller: https://agentstack.voostack.com/s/agent-pattern-labs - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.