career-ops README

The project's README from github.com/career-ops-hq/career-ops. As one markdown file: README.md.

career-ops

English | Español | Deutsch | Français | Português (Brasil) | 한국어 | 日本語 | 简体中文 | 繁體中文 | Українська | Русский | Polski | Dansk | தமிழ் | العربية | हिन्दी | Türkçe

career-ops Multi-Agent Job Search System

I spent months applying to jobs the hard way. So I engineered the system I wish I had.
Companies use AI to filter candidates. I just gave candidates AI to choose companies.
Now it's open source.

Hired with career-ops: verified count

Landed yours? Share it → · your card shows someone mid-search that the way out exists.

The three most recent hired stories

Every count is a public story you can audit → · every one of them started where you are now.

santifer%2Fcareer-ops | Trendshift

career-ops on Claude | Product Hunt

FEATURED IN

WIRED       Business Insider

career-ops Demo

740+ job listings evaluated · 100+ personalized CVs · 1 dream role landed

Created and maintained by Santiago Fernández de Valderrama Aparicio (@santifer)

Live star telemetry of career-ops-hq/career-ops

Discord

Latest release

Built with Claude Code

Also runs on any agent-skill-standard CLI. See Supported CLIs.
Claude Code OpenCode Antigravity CLI Codex Qwen Kimi GitHub Copilot Grok Build CLI
Node.js Go Playwright Bubble Tea MIT Trademark Policy

What Is This

career-ops (career-ops.org, also known as careerops) 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:

Important: This is NOT a spray-and-pray tool. career-ops 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.

career-ops 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.

The CareerOps Manifesto

career-ops is the first reference implementation of the CareerOps Manifesto. 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
Pipeline Integrity Automated merge, dedup, status normalization, health checks
Interview Suite Time-blocked prep plans, practice sessions with feedback, post-interview debriefs (interview/), and a company red-flag detector (interview-redflag)
Offer Stage Contract reading companion -- clause walk plus a lawyer question list (offer-prep) -- 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)
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
Beyond the CV Company research (deep) surfaces AI strategy, recent moves, engineering culture, and the angle your profile should take. Contact discovery (contacto) 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) 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:

npx @santifer/career-ops init

💡 npx ships with Node.js — 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:

cd career-ops
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.

Prefer to set it up manually? (git clone) 
git clone https://github.com/career-ops-hq/career-ops.git
cd career-ops && 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"

Global install

npm i -g @santifer/career-ops

This installs the career-ops binary globally so you can run it directly instead of via npx. Unlike npx @santifer/career-ops 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?

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 for the full setup guide, docs/RUNNING_ON_A_BUDGET.md for instructions on running career-ops cheaply using custom or local models (and docs/FREE_TIER.md for running it at zero cost on Antigravity CLI's free tier), docs/AUTOMATION.md for scheduling recurring scans and a zero-token triage-to-shortlist recipe, docs/APPLY_AUTOFILL.md for details on the ATS auto-fill flow, docs/LINKEDIN_JOIN.md for cross-referencing a LinkedIn connections export against the companies in your funnel, and docs/FAQ.md for answers to common setup questions, including how story provenance prevents invented numbers. Design principles live in ARCHITECTURE.md; runtime flows in docs/ARCHITECTURE.md.

Antigravity CLI Integration

career-ops 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

# 1. Run in the career-ops directory
cd career-ops
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

career-ops 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.

Interactive Codex

cd career-ops
codex

Slash commands are not guaranteed in Codex. If /career-ops is unavailable, ask Codex to run the mode directly in plain language:

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)

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

c

career-ops (career-ops-hq/career-ops)

Searching Database…

75.4K ·GitHub
Career-ops
Что это такое?career-ops — это открытый ИИ-агент для поиска работы, который работает локально внутри вашего ИИ-CLI для программирования (Claude Code, Codex, OpenCode и других): сканирует доски вакансий, оценивает каждую вакансию по шкале от 1 до 5 на основе вашего резюме, адаптирует резюме и сопроводительное письмо под каждое объявление и отслеживает каждый отклик. Но кнопку «Отправить» вы всегда нажимаете сами.
Это самостоятельное приложение или оно работает внутри другого инструмента?Это пакет навыков для агентов, а не отдельное приложение, которое вы открываете. Ваш существующий ИИ-CLI для программирования (Claude Code, Codex, OpenCode, Antigravity, Gemini CLI и другие) загружает его и запускает за вас его слеш-команды и скрипты.
Как мне его запустить?Выполните 'npx @santifer/career-ops init'. Команда клонирует последний релиз в ./career-ops и установит зависимости. При первом запуске вас проведут через настройку резюме, профиля и целевых ролей просто в диалоге. Для постоянной команды вместо npx выполните 'npm i -g @santifer/career-ops'.
С какими агентами для программирования он работает и что ещё нужно?Нужны Node.js (npx входит в его состав) и ИИ-CLI для программирования, который поддерживает навыки агентов: Claude Code, Codex, OpenCode, Antigravity CLI, Gemini CLI, Grok Build и другие CLI, совместимые со стандартом навыков агентов. Под капотом для навигации по порталам вакансий используется Playwright.
Он сам отправляет отклики на вакансии?Нет. career-ops только оценивает, готовит черновики и даёт рекомендации. Окончательное решение всегда за вами, и кнопку «Отправить» вы нажимаете сами. Он никогда не отправляет письма и не нажимает кнопку отклика и советует не откликаться на вакансии с оценкой ниже 4.0/5.
Для кого это создано?Для соискателей, которые хотят ИИ-фильтр вместо отклика «всем подряд». Это для тех, кто готов передать ему своё резюме и карьерный контекст, чтобы он мог изучить их профиль и со временем улучшать оценку вакансий.
Можно ли запустить это на Windows, Mac или Linux?Да. Это CLI-пакет на Node.js, который устанавливается через npx/npm, поэтому работает на любой платформе, где доступны Node 18+ и ваш ИИ-CLI для программирования. Также предусмотрена настройка через Docker.
Что на самом деле содержит отчёт об оценке A-H?Он включает краткое описание роли, соответствие резюме с весовой оценкой важности каждого требования, стратегию уровня, исследование уровня зарплаты, персонализацию, подготовку к собеседованию по методу STAR+R, проверку легитимности вакансии, которая выявляет мошенничество и фиктивные вакансии, а также проверку права на работу. В итоге выставляется единая общая оценка от 1 до 5.
Можно ли пользоваться career-ops бесплатно или с ограниченным бюджетом?Да. docs/RUNNINGONABUDGET.md описывает использование дешёвых или локальных моделей, а docs/FREETIER.md документирует запуск без затрат на бесплатном тарифе Antigravity CLI.
Он только ищет вакансии или также помогает с собеседованиями и переговорами?Помимо сканирования вакансий и адаптации резюме, он создаёт банк историй для собеседований (STAR+Reflection), помогает с подготовкой к собеседованиям и разбором после них, генерирует сценарии переговоров о зарплате и анализирует пункты контракта до того, как вы примете оффер.
Как он находит вакансии для оценки?Он сканирует более 100 заранее настроенных компаний (Anthropic, OpenAI, ElevenLabs, Retool, n8n и другие), а также выполняет пользовательские запросы на Ashby, Greenhouse, Lever, Wellfound и страницах карьеры компаний с помощью Playwright.
What are similar projects?ai-job-search, job-application-agent, Resume-Matcher, Awesome-CV, rendercv, ASu-skills, get_jobs, pinloop-cli
Which topics is it in?job-hunting, cv, interview-prep, resume, latex, job-search, playwright, career, cli-tool, local-first, ai-agent, agent-skills
Creator
career-ops-hq
Size
97.9 MB
Stars
75.4K
Updated
CommitOct 17Releasecareer-ops-v1.37.0Oct 16
Age
6mo
Commits · 90 Days