career-ops: AI-Powered Job Search Pipeline

career-ops is an AI-driven job search command center designed to work via AI coding CLIs. It automates the heavy lifting of job searching while maintaining a Human-in-the-Loop model, meaning the AI recommends and prepares materials, but the user makes all final decisions and submissions.

Key Capabilities

• Auto-Pipeline: Provide a job URL to receive a full evaluation, an ATS-optimized PDF resume, and an automatic entry in your application tracker.
• 6-Block Evaluation: Evaluates jobs based on role description, resume fit, leveling strategy, compensation research, personalization, and interview prep (STAR+R). It also includes a legitimacy check (Block G) to detect potential scams or fake listings.
• ATS PDF Generation: Generates resumes with implemented keywords using specific typography (Space Grotesk + DM Sans) optimized for Applicant Tracking Systems.
• Portal Scanner: Automatically scans 45+ pre-configured companies (e.g., Anthropic, OpenAI, ElevenLabs) and supports custom queries via Ashby, Greenhouse, Lever, and Wellfound.
• Interview Story Bank: Accumulates STAR+Reflection stories from your evaluations to build 5-10 master stories for behavioral interviews.
• Batch Processing: Allows for parallel evaluation of multiple job offers using sub-agents.
• TUI Dashboard: A Terminal User Interface for viewing, filtering, and sorting your application pipeline.
• Negotiation Scripts: Provides frameworks for salary negotiation, handling geographic pay discounts, and leveraging competing offers.

career-ops is an AI-driven job search command center designed to be used via AI coding CLIs (such as Claude Code, Gemini CLI, or OpenCode). It acts as a filter to help users find high-quality job opportunities rather than a tool for mass applications.

Key Capabilities:

• Automated Pipeline: Input a job URL to receive a structured evaluation, a personalized ATS-optimized PDF resume, and an entry in your application tracker.
• 6-Block Evaluation: Evaluates roles based on role summary, CV match, grade strategy, compensation research, personalization, and interview prep (STAR+R), plus a legitimacy check (Block G) to identify fraudulent or phantom listings.
• ATS PDF Generation: Creates resumes with keyword injection using Space Grotesk and DM Sans fonts.
• Portal Scanner: Automatically scans 45+ international companies and supports Russian platforms (e.g., hh.ru, Habr Career, trudvsem.ru) via manual configuration in portals.yml.
• Batch Processing: Evaluates multiple job offers in parallel using sub-agents.
• Dashboard TUI: A Terminal User Interface for viewing, filtering, and sorting your application pipeline.
• Human-in-the-Loop: The AI recommends and prepares, but the user makes all final decisions and performs all submissions.

career-ops is an AI-driven job search command center designed to be used via AI coding CLIs. It operates on a 'Human-in-the-Loop' model, meaning the AI performs evaluations and generates drafts, but the user makes all final decisions and executions.

Core Capabilities:

• Automated Pipeline: Paste a URL to trigger evaluation, PDF generation, and tracker recording.
• 6-Block Evaluation: Evaluates roles based on Role Summary, CV Match, Level Strategy, Compensation Research, Personalization, and Interview Prep (STAR+R). Includes a 'Block G' to detect scams or ghost jobs.
• ATS-Optimized PDF Generation: Creates keyword-injected CVs using Space Grotesk and DM Sans designs.
• Job Portal Scanner: Pre-configured for 45+ companies (e.g., Anthropic, OpenAI, ElevenLabs) and supports custom queries across Ashby, Greenhouse, Lever, and Wellfound.
• Batch Processing: Uses sub-agents to evaluate multiple job offers in parallel.
• Interview Story Bank: Accumulates STAR+Reflection stories during evaluations to prepare for behavioral interviews.
• Dashboard TUI: A terminal UI to view, filter, and sort your application pipeline.
• Negotiation Scripts: Provides frameworks for salary negotiation and handling competing offers.

The project is organized into several key directories for configuration, automation, and data management:

• CLAUDE.md: Agent instructions.
• cv.md: Your personal resume (must be created by you).
• article-digest.md: Evidence of your achievements (optional).
• config/: Contains profile.example.yml for personal profile templates.
• modes/: Contains 14 skill modes (e.g., oferta.md for single job evaluation, pdf.md for PDF generation, scan.md for platform scanning, batch.md for batch processing).
• templates/: Contains cv-template.html (ATS-optimized), portals.example.yml (scanner settings), and states.yml (standard status list).
• batch/: Contains batch-prompt.md and batch-runner.sh (coordinator script).
• dashboard/: Go-based TUI pipeline viewer.
• data/: Your tracking data (git-ignored).
• reports/: Evaluation reports (git-ignored).
• output/: Generated PDFs (git-ignored).
• docs/: Configuration, customization, and architecture documentation.

The "brain" of career-ops consists of Markdown prompt files located in the modes/ directory. Each file defines a specific workflow (e.g., evaluating a job, generating a PDF, or scanning portals). When you use an AI coding CLI (like Claude Code or Gemini CLI), the agent reads the relevant mode file along with shared context and your user files to execute the requested task.

Key Workflow Modes:

• job (oferta.md): Full A-G evaluation of a single job offer.
• jobs (ofertas.md): Comparison of multiple job offers.
• auto (auto-pipeline.md): Full automatic pipeline (evaluate + PDF + tracker) triggered by a pasted JD or URL.
• pipeline (pipeline.md): Processes the URL inbox found in data/pipeline.md.
• scan (scan.md): Portal scanner for job discovery.
• apply (apply.md): Live application assistant for form filling (does not submit).
• pdf (pdf.md): Generates ATS-optimized PDFs.
• tracker (tracker.md): Provides an overview of your applications tracker.
• interview-prep (interview-prep.md): Provides company-specific interview intelligence.

The project is organized into several key directories and files that define the agent's behavior and your personal data:

• AGENTS.md: Canonical instructions for the agent (used by all CLIs).
• CLAUDE.md: Claude Code wrapper (imports AGENTS.md).
• cv.md: Your personal CV (you must create this).
• article-digest.md: Optional file for your proof points.
• config/profile.example.yml: Template for your professional profile.
• modes/: Contains 14 operational modes (e.g., oferta.md for individual evaluation, pdf.md for PDF generation, scan.md for portal scanning, batch.md for batch processing).
• templates/: Contains cv-template.html (ATS-optimized), portals.example.yml (scanner config), and states.yml (canonical states).
• batch/: Contains batch-prompt.md and batch-runner.sh for batch processing.
• dashboard/: Source for the Go-based TUI.
• data/: Tracking data (gitignored).
• reports/: Evaluation reports (gitignored).
• output/: Generated PDFs (gitignored).

The career-ops name and brand are protected by a trademark policy that is separate from the MIT license governing the source code. While the code is free to use, modify, and redistribute under MIT, the name "career-ops" and its visual identity are reserved.

Permitted Uses (No permission needed)

• Code usage: Forking, modifying, and building on the source code.
• Attribution: Describing lineage such as "based on career-ops", "works with career-ops", or "fork of career-ops".
• Distinct Naming: Creating a fork with its own unique product name.
• Content Creation: Educational, journalistic, or personal use (blogs, tutorials, videos, research).
• Community: Using the name in PRs, issues, and discussions.

Restricted Uses (Written permission required)

Any use that implies official affiliation, endorsement, or sponsorship requires written permission. This includes:

• Product/Service Names: Using "career-ops" as a prefix, suffix, or part of a name (e.g., "career-ops Pro", "CareerOps by [vendor]").
• Affiliation Claims: Phrasings like "Powered by career-ops", "Official career-ops", or "Partner of career-ops".
• Commercial Identity: Domain names, social handles, or app store listings containing "career-ops" for commercial purposes.
• Visual Assets: Using logos, wordmarks, or color schemes in a commercial context.
• Certifications: Implied approval such as "career-ops Certified".