# career-ops-hq/career-ops

> career-ops is an open-source AI job search agent that helps you decide whether a job posting is worth applying to. You paste a job posting, and it checks whether the posting is still open, scores the role against your CV, and drafts a tailored CV, cover letter and application answers for you to review. The project is written mainly in JavaScript, with TypeScript and Go code as well.

Source: https://github.com/career-ops-hq/career-ops
Indexed: commit 5d0a07e on 2026-11-10 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: Command-line tool
- Language: JavaScript
- Stars: 81,496 at index time
- License: MIT
- Code health: 7.7/10, Good
- Last commit: 2026-11-09
- Contributors: 107

## Install

From the README: https://github.com/career-ops-hq/career-ops#quick-start

Clone the career-ops repository.
    git clone https://github.com/career-ops-hq/career-ops.git

Run the one-command installer, which clones the latest release into a career-ops folder and installs dependencies.
    npx @santifer/career-ops init

Change into the new career-ops folder.
    cd career-ops

## How it works

Input enters through the AI CLI you open in the project folder, where you paste a job URL or description. The skill file at .claude/skills/career-ops/SKILL.md is a central file that defines how the AI runs the career-ops workflow. scan.mjs is a hotspot file for scanning job listings, and generate-pdf.mjs produces the tailored CV PDFs. verify-cv-facts.mjs checks that the numbers and facts in a generated CV appear in your own source material. The scaffolder/bin/cli.mjs entry point runs the init command that sets up a workspace, while web/server.mjs and dashboard/main.go serve the web interface and terminal dashboard. Reports, PDFs and tracker rows are written to your machine.

- dashboard/main.go: entry point
- scaffolder/bin/cli.mjs: entry point
- web/server.mjs: entry point
- web/src/app/api/templates/manage.ts: entry point
- web/src/lib/cv-studio/server.ts: entry point
Modules: tests, web, root, providers, dashboard, lib, plugins, .github. 3,054 files, 384,309 lines, 19,219 symbols.

## Code health

- Score: 7.7/10 (Good)
- Rank: #68 of 4,000+ indexed repos
- Hotspots: scan.mjs, web/src/components/pipeline-view.tsx, verify-cv-facts.mjs, generate-pdf.mjs, doctor.mjs
- Lowest file: scan.mjs
- Dead code: 26 findings

## Maintenance

- Last commit 2026-11-09, 500 commits
- 107 contributors, bus factor 3

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/career-ops-hq/career-ops/security

## More

- Page: https://repowise.dev/repo/career-ops-hq/career-ops
- Ask this codebase: https://repowise.dev/repo/career-ops-hq/career-ops/chat
- Docs: https://repowise.dev/repo/career-ops-hq/career-ops/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/career-ops-hq/career-ops