Career-Ops

AI-powered job search pipeline built on Claude Code. Evaluate offers, generate tailored CVs, scan portals, and track everything. 56K+ GitHub stars.

What It Does

Career-ops turns Claude Code into a job search command center. Instead of manually tracking applications in a spreadsheet, it provides an agentic pipeline that evaluates, generates, scans, and tracks.

Feature Description
Auto-Pipeline Paste a URL → full evaluation + PDF + tracker entry
6-Block Evaluation Role summary, CV match, level strategy, comp research, personalization, interview prep (STAR+R)
Interview Story Bank Accumulates STAR+Reflection stories across evaluations
Negotiation Scripts Salary negotiation frameworks, geographic discount pushback, competing offer positioning
ATS PDF Generation Keyword-injected CVs with Space Grotesk + DM Sans
Portal Scanner 45+ companies pre-configured + custom queries across Ashby, Greenhouse, Lever, Wellfound
Batch Processing Parallel evaluation with claude -p workers
Dashboard TUI Go terminal UI to browse, filter, sort pipeline
Pipeline Integrity Automated merge, dedup, status normalization, health checks

Quick Start

git clone https://github.com/santifer/career-ops.git
cd career-ops && npm install
npx playwright install chromium

npm run doctor           # validate prerequisites
cp config/profile.example.yml config/profile.yml
cp templates/portals.example.yml portals.yml
# Create cv.md with your resume in markdown

Usage (Slash Commands)

/career-ops                → show all commands
/career-ops {paste JD}     → full pipeline (evaluate + PDF + tracker)
/career-ops scan           → scan portals for new offers
/career-ops pdf            → generate ATS-optimized CV
/career-ops batch          → batch evaluate multiple offers
/career-ops tracker        → view application status
/career-ops apply          → fill application forms with AI
/career-ops pipeline       → process pending URLs
/career-ops contacto       → LinkedIn outreach message
/career-ops deep           → deep company research
/career-ops training       → evaluate a course/cert
/career-ops project        → evaluate a portfolio project

Architecture

Job URL / Description
        │
        ▼
┌──────────────────┐
│  Archetype       │  Classifies role type
│  Detection       │
└────────┬─────────┘
         │
┌────────▼─────────┐
│  A-F Evaluation   │  Match, gaps, comp, STAR stories
│  (reads cv.md)    │
└────────┬─────────┘
         │
    ┌────┼────┐
    ▼    ▼    ▼
 Report  PDF  Tracker
  .md   .pdf   .tsv

Tech Stack

  • Agent: Claude Code with custom skills and modes (14 skill modes)
  • PDF: Playwright/Puppeteer + HTML template
  • Scanner: Playwright + Greenhouse API + WebSearch
  • Dashboard: Go + Bubble Tea + Lipgloss (Catppuccin Mocha)
  • Data: Markdown tables + YAML config + TSV batch files

The reviewed local artifact shows the dashboard as a terminal workbench: scored offers, tabs for evaluated/applied/interview/no-apply queues, salary/status fields, and rank-style filtering. That matters because career-ops is not merely a prompt pack; it is a real operator surface around a job-search state machine. Source: local artifact, 2026-06-30

Version Snapshot

Surface Snapshot
Latest release career-ops-v1.15.0, published 2026-06-29
Main HEAD cbde5c4d5c5e6a0c420ad550bfadcdaf78a1e6ca, 2026-06-30 commit fix(cv-template): keep role titles from orphaning at page breaks (#1366)
GitHub signal 56,825 stars, 11,240 forks, MIT license, checked 2026-06-30

Integration with Wiki

  1. Kevin's resume source lives at raw/career/resume-kevin-liu.tex and is mirrored to Resume, Kevin B. Liu
  2. Career-ops reads cv.md (markdown version) for evaluations and tailoring
  3. The Recruiter Discovery Workflow automation feeds target companies into portals.yml
  4. Job scan results feed back into Career Profile for tracking
  5. Interview story bank cross-references with Frontend and Design Skills for build-in-public content

Key Files

File Purpose
cv.md Your resume in markdown (career-ops reads this)
config/profile.yml Your profile, preferences, scoring weights
portals.yml Companies and search queries for scanner
modes/_shared.md Shared context across all modes
modes/oferta.md Single offer evaluation
modes/pdf.md PDF generation mode
modes/scan.md Portal scanning mode
templates/cv-template.html ATS-optimized HTML template

Customization

Career-ops is designed to be personalized by Claude itself. Ask Claude to change archetypes, scoring weights, negotiation scripts, or company lists. It reads the same files it uses.


Timeline