<h1 align="center">Jobify ๐ผ๐ค</h1>
<p align="center"><strong>Autonomous AI Job Search, Intelligent Evaluation & Application Engine</strong></p>
<div align="center">
[English](README.md) | [Espaรฑol](README.es.md) | [Deutsch](README.de.md) | [Franรงais](README.fr.md) | [Portuguรชs (Brasil)](README.pt-BR.md) | [ํ๊ตญ์ด](README.ko-KR.md) | [ๆฅๆฌ่ช](README.ja.md) | [็ฎไฝไธญๆ](README.cn.md) | [็น้ซไธญๆ](README.zh-TW.md) | [ะฃะบัะฐัะฝััะบะฐ](README.ua.md) | [ะ ัััะบะธะน](README.ru.md) | [Polski](README.pl.md) | [Dansk](README.da.md) | [เฎคเฎฎเฎฟเฎดเฏ](README.ta.md) | [ุงูุนุฑุจูุฉ](README.ar.md) | [เคนเคฟเคจเฅเคฆเฅ](README.hi.md) | [Tรผrkรงe](README.tr.md)
</div>
<p align="center">
<a href="https://github.com/authrain-cloud-abdullahformuli"><img src="docs/hero-banner.jpg" alt="career-ops Multi-Agent Job Search System" width="800"></a>
</p>
<p align="center">
<em>I spent months applying to jobs the hard way. So I engineered the system I wish I had.</em><br>
Companies use AI to filter candidates. <strong>I just gave candidates AI to <em>choose</em> companies.</strong><br>
<em>Now it's open source.</em>
</p>
<hr>
<p align="center">
<a href="HIRED.md"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2Fauthrain-cloud-abdullahformuli%2Fjobify%2Fmain%2Fdocs%2Fhired-count.json&query=%24.count&label=%F0%9F%8E%89%20HIRED%20WITH%20CAREER-OPS&suffix=%20verified&color=2ea44f&style=for-the-badge&labelColor=2b3137" alt="Hired with career-ops: verified count"></a>
</p>
<p align="center"><sub>Landed yours? <a href="https://github.com/authrain-cloud-abdullahformuli/jobify/issues/new?template=i-got-hired.yml">Share it โ</a> ยท your card shows someone mid-search that the way out exists.</sub></p>
<p align="center">
<a href="HIRED.md"><img src="docs/hired-wall.svg" alt="The three most recent hired stories" width="800"></a>
</p>
<p align="center"><sub>Every count is a public story you can <a href="HIRED.md">audit โ</a> ยท every one of them started where you are now.</sub></p>
<p align="center">
<a href="https://trendshift.io/repositories/25195" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/25195" alt="authrain-cloud-abdullahformuli%2Fjobify | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
</p>
<p align="center">
<a href="https://www.producthunt.com/products/santifer-io?utm_source=badge-featured&utm_medium=badge" target="_blank" rel="noopener noreferrer"><img src="docs/press/producthunt.svg" alt="career-ops on Claude | Product Hunt" style="width: 206px; height: 54px; vertical-align: middle;" width="206" height="54"/></a>
</p>
<p align="center"><sub>FEATURED IN</sub></p>
<p align="center">
<a href="https://wired.com.gr/article/to-ai-ergaleio-pou-fernei-epanastasi-ston-tropo-pou-psachnoume-douleia/" rel="noopener noreferrer nofollow"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/press/wired-dark.svg"><img src="docs/press/wired.svg" alt="WIRED" height="32"></picture></a>
<a href="https://www.businessinsider.com/how-i-built-tool-filter-job-listings-landed-head-ai-2026-4" rel="noopener noreferrer nofollow"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/press/business-insider-dark.svg"><img src="docs/press/business-insider.svg" alt="Business Insider" height="32"></picture></a>
</p>
---
<p align="center">
<img src="docs/demo.gif" alt="career-ops Demo" width="800">
</p>
<p align="center"><strong>740+ job listings evaluated ยท 100+ personalized CVs ยท 1 dream role landed</strong></p>
<p align="center"><sub>Created and maintained by <a href="https://github.com/authrain-cloud-abdullahformuli">Abdullah Formuli</a> (<a href="https://github.com/authrain-cloud-abdullahformuli">@abdullahformuli</a>)</sub></p>
<p align="center">
<a href="https://warpchart.dev/hq">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://warpchart.dev/api/chart?theme=dark&v=3">
<img alt="Live star telemetry of authrain-cloud-abdullahformuli/jobify" src="https://warpchart.dev/api/chart?theme=light&v=3" loading="lazy">
</picture>
</a>
</p>
<p align="center">
<a href="https://discord.gg/8pRpHETxa4"><img src="https://img.shields.io/badge/Join_the_community-Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord"></a>
</p>
<p align="center">
<a href="https://github.com/authrain-cloud-abdullahformuli/jobify/releases/latest"><img src="https://img.shields.io/npm/v/%40authrain-cloud-abdullahformuli%2Fjobify?style=for-the-badge&labelColor=2b3137&color=2ea44f&label=release" alt="Latest release"></a>
</p>
<p align="center">
<a href="https://claude.com/claude-code"><img src="https://img.shields.io/badge/Built_with-Claude_Code-000?style=for-the-badge&logo=anthropic&logoColor=white" alt="Built with Claude Code"></a>
</p>
<p align="center">
<sub>Also runs on any agent-skill-standard CLI. See <a href="docs/SUPPORTED_CLIS.md">Supported CLIs</a>.</sub><br>
<img src="https://img.shields.io/badge/Claude_Code-000?style=flat&logo=anthropic&logoColor=white" alt="Claude Code">
<img src="https://img.shields.io/badge/OpenCode-111827?style=flat&logo=terminal&logoColor=white" alt="OpenCode">
<img src="https://img.shields.io/badge/Antigravity_CLI-4285F4?style=flat&logo=google&logoColor=white" alt="Antigravity CLI">
<img src="https://img.shields.io/badge/Codex-412991?style=flat&logo=openai&logoColor=white" alt="Codex">
<img src="https://img.shields.io/badge/Qwen-615CED?style=flat" alt="Qwen">
<img src="https://img.shields.io/badge/Kimi-FF4B4B?style=flat" alt="Kimi">
<img src="https://img.shields.io/badge/GitHub_Copilot-000?style=flat&logo=githubcopilot&logoColor=white" alt="GitHub Copilot">
<img src="https://img.shields.io/badge/Grok_Build_CLI-000?style=flat&logo=x&logoColor=white" alt="Grok Build CLI">
<br>
<img src="https://img.shields.io/badge/Node.js-339933?style=flat&logo=node.js&logoColor=white" alt="Node.js">
<img src="https://img.shields.io/badge/Go-00ADD8?style=flat&logo=go&logoColor=white" alt="Go">
<img src="https://img.shields.io/badge/Playwright-2EAD33?style=flat&logo=playwright&logoColor=white" alt="Playwright">
<img src="https://img.shields.io/badge/Bubble_Tea-FF75B5?style=flat&logo=go&logoColor=white" alt="Bubble Tea">
<img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT">
<a href="TRADEMARK.md"><img src="https://img.shields.io/badge/Trademark-Policy-blue.svg" alt="Trademark Policy"></a>
</p>
## What Is This
Jobify ([github.com/authrain-cloud-abdullahformuli/jobify](https://github.com/authrain-cloud-abdullahformuli/jobify), built & maintained by **Abdullah Formuli**) is an open-source AI job search that runs locally inside any AI coding CLI: it evaluates offers, tailors your CV and tracks every application, and you always have the final call. Instead of manually tracking applications in a spreadsheet, you get an AI-powered pipeline that:
- **Evaluates offers** into a structured report -- blocks A through H, with a global 1-5 score reached by holistic judgement across five dimensions rather than an arithmetic formula. Block B's per-requirement importance column and block G's posting-legitimacy assessment are both separate, score-neutral signals that never affect the score; block H is drafted only at 4.5 and above
- **Generates tailored PDFs** -- ATS-optimized CVs customized per job description
- **Scans portals** automatically (Greenhouse, Ashby, Lever, company pages)
- **Processes in batch** -- evaluate 10+ offers in parallel with sub-agents
- **Tracks everything** in a single source of truth with integrity checks
- **Researches companies and finds the right person to contact** -- applications get you in the queue; research gets you a conversation
> **Important: This is NOT a spray-and-pray tool.** Jobify is a filter -- it helps you find the few offers worth your time out of hundreds. The system strongly recommends against applying to anything scoring below 4.0/5. Your time is valuable, and so is the recruiter's. Always review before submitting.
Jobify is agentic: whichever AI coding CLI you choose navigates career pages with Playwright, evaluates fit by reasoning about your CV vs the job description (not keyword matching), and adapts your resume per listing.
> **Heads up: the first evaluations won't be great.** The system doesn't know you yet. Feed it context -- your CV, your career story, your proof points, your preferences, what you're good at, what you want to avoid. The more you nurture it, the better it gets. Think of it as onboarding a new recruiter: the first week they need to learn about you, then they become invaluable.
Built by someone who used it to evaluate 740+ job offers, generate 100+ tailored CVs, and land a Head of Applied AI role. [Read the full case study](https://github.com/authrain-cloud-abdullahformuli/career-ops-system).
## The CareerOps Manifesto
Jobify is the first reference implementation of [the CareerOps Manifesto](https://github.com/authrain-cloud-abdullahformuli/jobify/manifesto?utm_source=readme). read it. if it says what you believe, sign it. your signature becomes a commit.
## Features
| Feature | Description |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- |
| **Auto-Pipeline** | Paste a URL, get a full evaluation + PDF + tracker entry |
| **A-H Evaluation** | Role summary, CV match (with how much each requirement matters for this posting, and whether that weight came from the JD's own wording, its structure, or an estimate โ labelled per requirement, and an estimate can never be top-band), level strategy, comp research, personalization, interview prep (STAR+R) -- plus a Block G posting-legitimacy check that flags scams and ghost jobs, and a Work-Auth signal that flags an explicit no-sponsorship JD as a hard blocker |
| **Interview Story Bank** | Accumulates STAR+Reflection stories across evaluations -- 5-10 master stories that answer any behavioral question |
| **Negotiation Scripts** | Salary negotiation frameworks, geographic discount pushback, competing offer leverage |
| **ATS PDF Generation** | Keyword-injected CVs with Space Grotesk + DM Sans design |
| **Cover Letter Generator** | Research-backed cover letters with keyword mirroring, four interactive angle prompts (why/problems/approach/tone), draft-in-chat approval gate, and A4 PDF via the same HTML + Playwright pipeline as CVs. Auto-drafts on every evaluation; complete and generate on demand via `/career-ops cover` |
| **Application Email Drafts** | Formal recruiter/referral/cold application emails from a report or pasted JD, with subject line, attachment checklist, source-backed fit points, and a profile-driven contact block. Draft-only -- career-ops never sends, submits, or clicks anything. |
| **Portal Scanner** | 100+ companies pre-configured (Anthropic, OpenAI, ElevenLabs, Retool, n8n...) + custom queries across Ashby, Greenhouse, Lever, Wellfound |
| **Funded Company Discovery** | Review-first `company:funded` command surfaces recently funded companies and source diagnostics from structured public feeds without editing your data |
| **Batch Processing** | Parallel evaluation with headless CLI workers (`claude -p` / `opencode run`) |
| **Dashboard TUI** | Terminal UI to browse, filter, and sort your pipeline |
| **Human-in-the-Loop** | AI evaluates and recommends, you decide and act. The system never submits an application -- you always have the final call <!-- hitl: absolute guarantee. Do not add "automatically", "by itself", "without your permission" or any other hedge when translating this row. --> |
| **Pipeline Integrity** | Automated merge, dedup, status normalization, health checks |
| **Interview Suite** | Time-blocked prep plans, practice sessions with feedback, post-interview debriefs ([`interview/`](modes/interview/README.md)), and a company red-flag detector ([`interview-redflag`](modes/interview-redflag.md)) |
| **Offer Stage** | Contract reading companion -- clause walk plus a lawyer question list ([`offer-prep`](modes/offer-prep.md)) -- and a desired/advertised/actual salary-gap analyzer (`salary-gap.mjs`) |
| **Follow-ups & Replies** | Follow-up cadence calculator and seeded reminders (`followup-cadence.mjs`, `followup-seed.mjs`); employer reply classification into tracker updates ([`reply-watch`](modes/reply-watch.md)) |
| **Pattern Analysis** | Rejection patterns and per-ATS-channel advance rates (`analyze-patterns.mjs`), lifetime funnel stats (`stats.mjs`), repost/ghost-job detection (`detect-reposts.mjs`) |
| **Plugin System** | Opt-in integrations (Gmail, Notion, Apify + a community registry), disabled by default -- see [docs/PLUGINS.md](docs/PLUGINS.md) |
| **Beyond the CV** | Company research ([`deep`](modes/deep.md)) surfaces AI strategy, recent moves, engineering culture, and the angle your profile should take. Contact discovery ([`contacto`](modes/contacto.md)) identifies the hiring manager, recruiter, or team peer worth reaching out to and drafts a โค300-character LinkedIn message tuned to each contact type. Formal application email drafts ([`email`](modes/email.md)) turn an evaluated report or pasted JD into a subject line, body, and attachment checklist without sending, submitting, or clicking anything. Applications get you in the queue; research gets you a conversation. |
## Quick Start
**Fastest way โ one command:**
```bash
npx @authrain-cloud-abdullahformuli/jobify init
```
> ๐ก `npx` ships with [Node.js](https://nodejs.org) โ it runs the installer once,
> without installing anything globally. No Node yet? Install it first.
> (Already using a Claude Code / Gemini / Codex CLI? Then you already have it.)
This clones the latest release into `./career-ops` and installs dependencies. Then:
```bash
cd jobify
claude # or codex / qwen / opencode / agy / grok โ open your AI CLI here
```
**On first launch, career-ops walks you through setup โ your CV, profile and target roles โ just by chatting. Nothing to edit by hand.**
<details>
<summary><b>Prefer to set it up manually? (git clone)</b></summary>
```bash
git clone https://github.com/authrain-cloud-abdullahformuli/jobify.git
cd jobify && npm install
npx playwright install chromium # only needed for PDF generation
# 2. Check setup
npm run doctor # Validates all prerequisites
# 3. Configure
cp config/profile.example.yml config/profile.yml # Edit with your details
cp templates/portals.example.yml portals.yml # Customize companies
# 4. Add your CV
# Create cv.md in the project root with your CV in markdown
# 5. Open your AI CLI in this directory
claude # or codex / opencode / qwen / agy / grok
# Then ask your CLI to adapt the system to you:
# "Change the archetypes to backend engineering roles"
# "Translate the modes to English"
# "Add these 5 companies to portals.yml"
# "Update my profile with this CV I'm pasting"
# 6. Start using
# Paste a job URL or JD text to trigger auto-pipeline
# If your CLI supports slash commands, use /career-ops (or its CLI-specific alias)
# In Codex, ask for the same mode in plain language, e.g.:
# "Run the career-ops scan mode"
# "Run the career-ops pipeline mode for data/pipeline.md"
# "Run the career-ops pdf mode for the latest evaluated role"
# "Run the career-ops tracker mode and summarize the current statuses"
```
</details>
### Global install
```bash
npm i -g @authrain-cloud-abdullahformuli/jobify
```
This installs the `career-ops` binary globally so you can run it directly instead of via `npx`. Unlike `npx @authrain-cloud-abdullahformuli/jobify init` (which bootstraps a project directory), the global install gives you a persistent `career-ops` command available anywhere in your terminal.
**Which one should you use?**
- `npx @authrain-cloud-abdullahformuli/jobify init` โ best for first use; creates a dedicated project folder.
- `npm i -g @authrain-cloud-abdullahformuli/jobify` โ best once you have a project folder and want to run career-ops commands directly.
> **The system is designed to be customized by your AI coding CLI itself.** Modes, archetypes, scoring weights, negotiation scripts -- just ask it to change them. It reads the same files it uses, so it knows exactly what to edit.
See [docs/SETUP.md](docs/SETUP.md) for the full setup guide, [docs/RUNNING_ON_A_BUDGET.md](docs/RUNNING_ON_A_BUDGET.md) for instructions on running career-ops cheaply using custom or local models (and [docs/FREE_TIER.md](docs/FREE_TIER.md) for running it at zero cost on Antigravity CLI's free tier), [docs/AUTOMATION.md](docs/AUTOMATION.md) for scheduling recurring scans and a zero-token triage-to-shortlist recipe, [docs/APPLY_AUTOFILL.md](docs/APPLY_AUTOFILL.md) for details on the ATS auto-fill flow, [docs/LINKEDIN_JOIN.md](docs/LINKEDIN_JOIN.md) for cross-referencing a LinkedIn connections export against the companies in your funnel, and [docs/FAQ.md](docs/FAQ.md) for answers to common setup questions, including [how story provenance prevents invented numbers](docs/FAQ.md#why-does-career-ops-refuse-to-use-a-number-from-my-story-bank). Design principles live in [ARCHITECTURE.md](ARCHITECTURE.md); runtime flows in [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
## Antigravity CLI Integration
Jobify supports Antigravity CLI natively, the same way it supports Claude Code and OpenCode. All slash commands are available through the shared skill entrypoint, using the same `modes/*.md` evaluation logic.
Google has transitioned consumer Gemini CLI access to Antigravity CLI. `GEMINI.md` is now a no-op compatibility guard so Antigravity does not duplicate the full project instructions when it reads both `AGENTS.md` and `GEMINI.md`.
### Native Antigravity CLI
```bash
# 1. Run in the career-ops directory
cd jobify
agy
# 2. Use the unified /career-ops command with subcommands:
/career-ops "Senior AI Engineer at Anthropic..."
/career-ops pipeline
/career-ops scan
/career-ops pdf
/career-ops tracker
```
The skill is defined using the open standard in `.agents/skills/career-ops/SKILL.md` and symlinked/referenced for each supported CLI (e.g. `.claude/`, `.cursor/`, `.qwen/`, `.antigravitycli/`, `.grok/`).
## Codex Integration
Jobify supports Codex through the same shared router, but the invocation model is different from CLIs that auto-register slash commands. For the full guide, see [docs/CODEX.md](docs/CODEX.md).
### Interactive Codex
```bash
cd jobify
codex
```
Slash commands are not guaranteed in Codex. If `/career-ops` is unavailable, ask Codex to run the mode directly in plain language:
```text
Evaluate this JD with career-ops auto-pipeline: https://company.com/jobs/123
Run the career-ops scan mode and summarize new matches.
Run the career-ops pipeline mode for data/pipeline.md.
Run the career-ops pdf mode for the latest evaluated role.
Run the career-ops tracker mode and summarize the current statuses.
```
### One-shot Codex (`codex exec`)
```bash
codex exec "Evaluate this JD with career-ops auto-pipeline: https://company.com/jobs/123"
codex exec "Run career-ops scan mode in this repo and summarize new matches."
codex exec "Run career-ops pipeline mode for data/pipeline.md."
codex exec "Run career-ops pdf mode for the latest evaluated role."
codex exec "Run career-ops tracker mode and summarize the current statuses."
```
## Grok Build CLI Integration
Jobify supports Grok Build CLI natively, the same way it supports Claude Code and OpenCode. `AGENTS.md` is auto-loaded as project rules, and all slash commands are available through the shared skill entrypoint.
### Native Grok Build CLI
```bash
# 1. Run in the career-ops directory
cd jobify
grok
# 2. Use the unified /career-ops command with subcommands:
/career-ops "Senior AI Engineer at Anthropic..."
/career-ops pipeline
/career-ops scan
/career-ops pdf
/career-ops tracker
```
For headless batch workers, use `grok -p "prompt"` (add `--yolo` to auto-approve tool executions).
### Standalone Gemini API Script (No CLI install needed)
```bash
# 1. Get a free API key at https://aistudio.google.com/apikey
cp .env.example .env
# Edit .env, set GEMINI_API_KEY=your_key_here
# 2. Install dependencies
npm install
# 3. Evaluate a job description
node gemini-eval.mjs "We are looking for a Senior AI Engineer..."
node gemini-eval.mjs --file ./jds/my-job.txt
node agent-inbox.mjs add "..." # queue a request for the next session
npm run gemini:eval -- "JD text here"
```
> **Free tier:** Both options work without billing. Native CLI uses Google OAuth; the API script uses `gemini-3.6-flash` (rate limits are model- and tier-dependent; see Google AI docs for current quotas).
## Usage
career-ops uses a shared command router. In CLIs that register slash commands, it looks like this:
```
/career-ops โ Show all available commands
/career-ops {paste a JD} โ Full auto-pipeline (evaluate + PDF + tracker)
/career-ops scan โ Scan portals for new offers
/career-ops pdf โ Generate ATS-optimized CV
/career-ops cover โ Cover letter generator (paste JD or /career-ops cover {slug})
/career-ops email โ Formal application email draft (draft-only; never sends, submits, or clicks)
/career-ops batch โ Batch evaluate multiple offers
/career-ops tracker โ View application status
/career-ops apply โ Fill application forms with AI
/career-ops outcome โ Record application outcome & archive artifacts
/career-ops pipeline โ Process pending URLs
/career-ops contacto โ Find hiring manager / recruiter / peer + draft a โค300-char LinkedIn message per contact type
/career-ops deep โ Generate a structured 6-axis research prompt (AI strategy, recent moves, culture, challenges, competitors, candidate angle)
/career-ops training โ Evaluate a course/cert
/career-ops project โ Evaluate a portfolio project
```
Or just paste a job URL or description directly -- career-ops auto-detects it and runs the full pipeline.
In Codex, slash commands are not guaranteed. Use the same mode names in a prompt instead, or call them from `codex exec`.
## How It Works
```
You paste a job URL or description
โ
โผ
โโโโโโโโโโโโโโโโโโโโ
โ Archetype โ Classifies: LLMOps / Agentic / PM / SA / FDE / Transformation
โ Detection โ
โโโโโโโโโโฌโโโโโโโโโโ
โ
โโโโโโโโโโผโโโโโโโโโโ
โ A-H Evaluation โ Match, gaps, comp research, STAR stories, legitimacy
โ (reads cv.md) โ
โโโโโโโโโโฌโโโโโโโโโโ
โ
โโโโโโผโโโโโ
โผ โผ โผ
Report PDF Tracker
.md .pdf entry
```
## Pre-configured Portals
The scanner comes with **100+ companies** ready to scan and **45+ search queries** across major job boards. Copy `templates/portals.example.yml` to `portals.yml` and add your own:
**AI Labs:** Anthropic, OpenAI, Mistral, Cohere, LangChain, Pinecone
**Voice AI:** ElevenLabs, PolyAI, Parloa, Hume AI, Deepgram, Vapi, Bland AI
**AI Platforms:** Retool, Airtable, Vercel, Temporal, Glean, Arize AI
**Contact Center:** Ada, LivePerson, Sierra, Decagon, Talkdesk, Genesys
**Enterprise:** Salesforce, Twilio, Gong, Dialpad
**LLMOps:** Langfuse, Weights & Biases, Lindy, Cognigy, Speechmatics
**Automation:** n8n, Zapier, Make.com
**European:** Factorial, Attio, Tinybird, Clarity AI, Travelperk
**Job boards searched:** 55+ provider modules cover ATS APIs, board-wide feeds, XML/RSS feeds, markdown feeds, and local parsers. See [Supported job boards](docs/SUPPORTED_JOB_BOARDS.md) for the full table.
By default `node scan.mjs` (a.k.a. `npm run scan`) trusts what each ATS feed returns. Some companies leave stale postings in their public API even after the role is closed, so those expired entries can leak into `pipeline.md`. Pass `--verify` to launch Playwright after the API pass and drop expired postings before they hit the pipeline:
```bash
node scan.mjs --verify # zero-token discovery + Playwright liveness check
```
The verification is sequential and only runs against new offers (after dedup), so the cost stays bounded.
## Dashboard TUI
The built-in terminal dashboard lets you browse your pipeline visually:
```bash
npm run serve:dashboard # launch the TUI
npm run build:dashboard # optional: build the standalone binary
```
Features: 6 filter tabs, 4 sort modes, grouped/flat view, lazy-loaded previews, inline status changes.
There is also an **experimental web UI** (alpha, opt-in โ nothing runs unless you start it): see [`web/README.md`](web/README.md).
## Project Structure
```
career-ops/
โโโ AGENTS.md # Canonical agent instructions (all CLIs)
โโโ CLAUDE.md # Claude Code wrapper (imports AGENTS.md)
โโโ CODEX.md # Codex wrapper (imports AGENTS.md)
โโโ OPENCODE.md # OpenCode wrapper (imports AGENTS.md)
โโโ GEMINI.md # Legacy no-op guard to avoid Antigravity duplicate context
โโโ cv.md # Your CV (create this)
โโโ article-digest.md # Your proof points (optional)
โโโ config/
โ โโโ profile.example.yml # Template for your profile
โโโ modes/ # Skill modes
โ โโโ _shared.md # Shared context (customize this)
โ โโโ oferta.md # Single evaluation
โ โโโ pdf.md # PDF generation
โ โโโ cover.md # Cover letter generation
โ โโโ email.md # Formal application email drafts
โ โโโ scan.md # Portal scanner
โ โโโ batch.md # Batch processing
โ โโโ ...
โโโ templates/
โ โโโ cv-template.html # ATS-optimized CV template
โ โโโ portals.example.yml # Scanner config template
โ โโโ states.yml # Canonical statuses
โโโ batch/
โ โโโ batch-prompt.md # Self-contained worker prompt
โ โโโ batch-runner.sh # Orchestrator script
โโโ dashboard/ # Go TUI pipeline viewer
โโโ data/ # Your tracking data (gitignored)
โโโ reports/ # Evaluation reports (gitignored)
โโโ output/ # Generated PDFs (gitignored)
โโโ fonts/ # Space Grotesk + DM Sans
โโโ docs/ # Setup, customization, budget guide, architecture
โโโ examples/ # Sample CV, report, proof points
```
## External Data Directory (Optional)
By default, user-layer data (such as `cv.md`, `portals.yml`, and `data/` / `reports/` / `output/` folders) lives inside the project root folder.
To separate your personal data from the code (making it easier to switch branches, pull updates, or test multiple profiles), you can configure an external data directory using the following precedence:
1. **Environment Variables:** Set the `CAREER_OPS_ROOT` or `CAREER_OPS_DATA_DIR` environment variable:
```bash
export CAREER_OPS_ROOT=~/my-career-data
```
2. **Marker File:** Create a `.career-ops-data` file in the repository root containing the path to your data directory.
3. **Default:** Defaults to the repository root.
Once resolved, all user files are resolved and written relative to that folder, while prompt files and scripts continue to resolve relative to the repository.
- **Tracker Override:** You can also set `CAREER_OPS_TRACKER` to override the applications tracker file path directly.
- **Writes:** All write operations (such as merges) canonically target `{DATA_ROOT}/data/applications.md`.
The Go dashboard TUI, Node.js scripts, and AI agent modes all automatically respect this resolution hierarchy.
## Tech Stack
- **Agent**: AI coding CLI with shared skills and modes (`AGENTS.md` + CLI wrapper)
- **PDF**: Playwright + HTML template
- **Cover letters**: HTML template + Playwright (A4 PDF, same pipeline as CVs)
- **Scanner**: Playwright + Greenhouse API + WebSearch
- **Dashboard**: Go + Bubble Tea + Lipgloss (Catppuccin Mocha theme)
- **Data**: Markdown tables + YAML config + TSV batch files
## Also Open Source
- **[cv-santiago](https://github.com/authrain-cloud-abdullahformuli/cv-santiago)** -- The portfolio website (github.com/authrain-cloud-abdullahformuli) with AI chatbot, LLMOps dashboard, and case studies. If you need a portfolio to showcase alongside your job search, fork it and make it yours.
## FAQ
**What is career-ops?**
Jobify is an open-source AI job search that runs locally in your AI coding CLI (Claude Code, Codex, OpenCode and others) and leaves every decision to you. It evaluates job offers against your CV, generates ATS-tailored PDFs, finds the right person to contact, and tracks everything in one place: you always have the final call. It is the first reference implementation of the CareerOps Manifesto. More at [github.com/authrain-cloud-abdullahformuli/jobify](https://github.com/authrain-cloud-abdullahformuli/jobify).
**Can I run career-ops for free, or on a cheaper / local model?**
Yes. Jobify is CLI-agnostic and runs on free and local models โ via OpenRouter free models, Ollama, or any OpenAI-compatible endpoint โ so you are not tied to a paid subscription. See [docs/RUNNING_ON_A_BUDGET.md](docs/RUNNING_ON_A_BUDGET.md) for the full setup.
**I pay for Claude Pro/Max but Jobify is burning API credits. Why?**
Because an `ANTHROPIC_API_KEY` in your environment takes precedence over your logged-in subscription: the CLI uses the key and bills per token. Run `echo $ANTHROPIC_API_KEY`, and if it prints anything, remove it from your shell profile, restart the terminal and run `/login`. Batch mode is the exception, since `claude -p` workers do not use the interactive login: run `claude setup-token` once and export the result as `CLAUDE_CODE_OAUTH_TOKEN`. Full walkthrough in [docs/RUNNING_ON_A_BUDGET.md](docs/RUNNING_ON_A_BUDGET.md#2b-already-paying-for-a-subscription-make-sure-you-are-using-it).
**Which AI CLIs does career-ops work with?**
career-ops runs on any major AI coding CLI โ Claude Code, Codex, Gemini / Antigravity, OpenCode, Grok, Qwen and more โ through the open Agent Skill Standard, so it is never locked to a single vendor. Use the CLI you already have.
**How do I install career-ops on Windows?**
career-ops runs on Windows. Platform-specific setup and the known sharp edges โ Git Bash discovery, line endings, Task Scheduler โ are in [docs/WINDOWS.md](docs/WINDOWS.md). If skills fail to load with a symlink error during install, the fix is in [docs/FAQ.md](docs/FAQ.md). Full steps are in [docs/SETUP.md](docs/SETUP.md).
**Does career-ops auto-apply to jobs for me?**
No. Jobify is a filter, not a spray-and-pray auto-applier. The AI evaluates, ranks and drafts; you review and decide. It never submits, sends, or clicks anything โ you always have the final call. That human-in-the-loop design is the whole point.
**Is career-ops free and open source?**
Yes. Jobify is free and open source, and for the candidate it always will be โ it is the first reference implementation of the [CareerOps Manifesto](https://github.com/authrain-cloud-abdullahformuli/jobify/manifesto). Read it, and if it says what you believe, sign it.
## About the Author
I'm [Abdullah Formuli](https://github.com/authrain-cloud-abdullahformuli/about) (abdullahformuli) -- Head of Applied AI, former founder (built and sold a business that still runs with my name on it). I built career-ops to manage my own job search. It worked: I used it to land my current role.
Curious how this repo is maintained in ~4 hours a week? Read [Agentic maintenance: how Jobify is run by a fleet of AI agents](https://github.com/authrain-cloud-abdullahformuli/ai-agent-fleet).
My portfolio and other open source projects โ [github.com/authrain-cloud-abdullahformuli](https://github.com/authrain-cloud-abdullahformuli)
Wikidata: [Abdullah Formuli](https://www.wikidata.org/wiki/Q138710224) ยท [career-ops](https://www.wikidata.org/wiki/Q139007988).
## Disclaimer
**Jobify is a local, open-source tool, NOT a hosted service.** By using this software, you acknowledge:
1. **You control your data.** Your CV, contact info, and personal data stay on your machine and are sent directly to the AI provider you choose (Anthropic, OpenAI, etc.). We do not collect, store, or have access to any of your data.
2. **You control the AI.** The default prompts instruct the AI not to auto-submit applications, but AI models can behave unpredictably. If you modify the prompts or use different models, you do so at your own risk. **Always review AI-generated content for accuracy before submitting.**
3. **You comply with third-party ToS.** You must use this tool in accordance with the Terms of Service of the career portals you interact with (Greenhouse, Lever, Workday, LinkedIn, etc.). Do not use this tool to spam employers or overwhelm ATS systems.
4. **No guarantees.** Evaluations are recommendations, not truth. AI models may hallucinate skills or experience. The authors are not liable for employment outcomes, rejected applications, account restrictions, or any other consequences.
See [LEGAL_DISCLAIMER.md](LEGAL_DISCLAIMER.md) for full details. This software is provided under the [MIT License](LICENSE) "as is", without warranty of any kind.
## Contributors
<a href="https://github.com/authrain-cloud-abdullahformuli/jobify/graphs/contributors">
<img src="https://contrib.rocks/image?repo=authrain-cloud-abdullahformuli/jobify" />
</a>
Every person who has shipped code, docs, translations or tests is listed in
[CONTRIBUTORS.md](CONTRIBUTORS.md) โ including non-code contributions, which
the graph above cannot show.
Got hired using career-ops? [Share your story!](https://github.com/authrain-cloud-abdullahformuli/jobify/issues/new?template=i-got-hired.yml)
## License & Trademark
The code is licensed under [MIT](LICENSE). The "career-ops" name and
brand are governed by the [Trademark Policy](TRADEMARK.md), permissive
for community use, reserved for commercial product naming and
endorsement.
## Let's Connect
[](https://github.com/authrain-cloud-abdullahformuli)
[](https://linkedin.com/in/abdullahformuli)
[](https://github.com/authrain-cloud-abdullahformuli)
[](https://discord.gg/8pRpHETxa4)
[](mailto:hi@abdullahformuli.io)