career-harness
Career Harness: a Claude Code plugin for job search, CVs and applications.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/hrishi-alikatte--career-harness)HTML
<a href="/listings/hrishi-alikatte--career-harness"><img src="/api/listings/hrishi-alikatte--career-harness/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
First install [uv](https://docs.astral.sh/uv/), the small tool that runs the plugin's engine and safety checks. In a terminal:
# macOS brew install uv # or: curl -LsSf https://astral.sh/uv/install.sh | sh # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows (best effort) winget install --id=astral-sh.uv -e
Open a new terminal, check that `uv --version` works, then start Claude Code. Inside Claude Code, run:
/plugin marketplace add hrishi-alikatte/career-harness /plugin install career@career-harness
Then:
1. Make an empty folder for your job search and open Claude Code in it. This folder becomes your private workspace. Always open Claude in this folder: approvals only work in a session opened in the workspace folder, so a session started elsewhere cannot approve or send anything. 2. Run `/chrome` if Claude in Chrome is not connected yet. 3. Run `/career:setup`. Drop in your resume (PDF or DOCX), and optionally your LinkedIn PDF export, GitHub link and notes. It asks at most 10 plain questions, renders your master CV and asks you to confirm that everything on the page is true. This takes about 10 minutes. 4. Run `/career:hunt`. It polls company job boards, drops what does not fit, scores the rest, writes a CV, letter and form answers for the best ones, checks every claim, and stops at a batch. 5. Read the batch table and open the documents. Reply `OK`, or `OK except 3, 7`, or `no`. Send nothing else in that message. 6. Run `/career:apply --dry-run` once to watch a run that stops before Submit. Then run `/career:apply`. 7. Run `/career:status` to see counts, what needs you, interviews and follow-ups.
| Command | What it does | |---|---| | `/career:setup` | Builds your profile, evidence and search plan from your resume | | `/career:hunt` | Finds jobs, prepares applications, ends at a batch for your approval | | `/career:add <url>` | Runs one job you found through the same steps, ending in a batch of one | | `/career:apply` | Sends approved applications in your browser, `--dry-run` stops before Submit | | `/career:status` | Shows counts, batches waiting, things only you can do, interviews | | `/career:prep` | Builds an interview pack for one application | | `/career:follow-up` | Reads replies if you connect a mailbox and drafts follow-ups you send yourself | | `/career:profile` | Adds a project or role, changes targets, re-renders your master CV |
You can also ask in plain words: "set me up", "find me jobs", "send them".
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 15 lines
- {
- "name": "career-harness",
- "description": "Career Harness: a Claude Code plugin for job search, CVs and applications.",
- "owner": {
- "name": "Hrishi Alikatte",
- "url": "https://github.com/hrishi-alikatte"
- },
- "plugins": [
- {
- "name": "career",
- "source": "./",
- "description": "Find jobs, write evidence-backed CVs and letters, and apply in your browser after you approve each batch."
- }
- ]
- }
README.md · README · 139 lines
- # career-harness
- A Claude Code plugin that finds jobs that fit you, writes a CV and cover letter for each one from your real experience, and applies in your own browser after you approve the batch.
- Every claim in a CV or letter must point to something you told it. If a number, skill or claim has no source, the document fails the check and cannot go into a batch. Nothing is sent until you reply OK to a batch you have read, and every application leaves proof: the confirmation text, the answers sent and, with Claude in Chrome, before and after screenshots.
- ## Why this exists
- I built the first version for my own internship search. In one run of that private version I submitted 751 applications in 5 days, each with saved proof. The totals come from the proof files, not from memory. This repository is that harness rebuilt as a plugin anyone can install. Your data stays in a folder on your machine and never enters this repository.
- Hrishi Alikatte ([github.com/hrishi-alikatte](https://github.com/hrishi-alikatte))
- ## Quickstart
- First install [uv](https://docs.astral.sh/uv/), the small tool that runs the plugin's engine and safety checks. In a terminal:
- ```bash
- # macOS
- brew install uv # or: curl -LsSf https://astral.sh/uv/install.sh | sh
- # Linux
- curl -LsSf https://astral.sh/uv/install.sh | sh
- # Windows (best effort)
- winget install --id=astral-sh.uv -e
- ```
- Open a new terminal, check that `uv --version` works, then start Claude Code. Inside Claude Code, run:
- ```text
- /plugin marketplace add hrishi-alikatte/career-harness
- /plugin install career@career-harness
- ```
- Then:
- 1. Make an empty folder for your job search and open Claude Code in it. This folder becomes your private workspace. Always open Claude in this folder: approvals only work in a session opened in the workspace folder, so a session started elsewhere cannot approve or send anything.
- 2. Run `/chrome` if Claude in Chrome is not connected yet.
- 3. Run `/career:setup`. Drop in your resume (PDF or DOCX), and optionally your LinkedIn PDF export, GitHub link and notes. It asks at most 10 plain questions, renders your master CV and asks you to confirm that everything on the page is true. This takes about 10 minutes.
- 4. Run `/career:hunt`. It polls company job boards, drops what does not fit, scores the rest, writes a CV, letter and form answers for the best ones, checks every claim, and stops at a batch.
- 5. Read the batch table and open the documents. Reply `OK`, or `OK except 3, 7`, or `no`. Send nothing else in that message.
- 6. Run `/career:apply --dry-run` once to watch a run that stops before Submit. Then run `/career:apply`.
- 7. Run `/career:status` to see counts, what needs you, interviews and follow-ups.
- | Command | What it does |
- |---|---|
- | `/career:setup` | Builds your profile, evidence and search plan from your resume |
- | `/career:hunt` | Finds jobs, prepares applications, ends at a batch for your approval |
- | `/career:add <url>` | Runs one job you found through the same steps, ending in a batch of one |
- | `/career:apply` | Sends approved applications in your browser, `--dry-run` stops before Submit |
- | `/career:status` | Shows counts, batches waiting, things only you can do, interviews |
- | `/career:prep` | Builds an interview pack for one application |
- | `/career:follow-up` | Reads replies if you connect a mailbox and drafts follow-ups you send yourself |
- | `/career:profile` | Adds a project or role, changes targets, re-renders your master CV |
- You can also ask in plain words: "set me up", "find me jobs", "send them".
- ## How it works
- ```mermaid
- flowchart LR
- A[Resume and notes] --> B[setup: profile, evidence, search plan]
- B --> C[hunt: discover, screen, score]
- C --> D[Write CV, letter, answers]
- D --> E{Gate: facts, ATS, voice}
- E -- fails --> D
- E -- passes --> F[Batch for your OK]
- F -- you reply OK --> G[apply: your browser, one tab per job]
- G --> H[Proof: confirmation text and screenshots]
- G --> I[Needs you: login, CAPTCHA, a question only you can answer]
- ```
- - **Skills and agents** do the reading and writing. Skills are the commands you type. Agents are helpers with narrow tools: a scout, a triager, a writer, two reviewers, an applier and a researcher.
- - **A local engine** does everything that must be exact: screening, de-duplication, fact checks, PDF rendering, batches, approvals and proof. It runs as a local MCP server named `jobs` and makes no model calls.
- - **Hooks** enforce the rules that must not depend on a model following instructions. Uploads are blocked unless the file belongs to a job in a batch you approved.
- - **Playbooks** in `portals/` tell the applier how each application system behaves (Greenhouse, Lever, Ashby, Workable, SmartRecruiters, Workday, SuccessFactors, Taleo, iCIMS, Teamtailor, Recruitee, LinkedIn Easy Apply, Indeed Apply, French sites and more). They are plain Markdown, so you can fix one when a site changes.
- - **Region packs** in `regions/` hold country rules: job sites, CV length, letter format, form norms. Packs ship for `global`, `fr` and `ch`.
- More detail: [architecture](docs/architecture.md), [data contracts](docs/data-contracts.md).
- ## What it will never do
- - Send an application you did not approve. Approval is one whole message you type, checked against a signed log of your messages, in a session opened in your workspace folder.
- - Say something untrue. Every CV bullet cites evidence; numbers, skills and names are checked by code before a PDF is accepted.
- - Type a password or one-time code, solve a CAPTCHA, or create an account. It stops, leaves the tab open and tells you.
- - Tick marketing or talent-pool boxes. Demographic questions get "prefer not to say" unless you set your own default.
- - Send an email or a LinkedIn message for you. It drafts; you send.
- - Retry a submit that gave no confirmation, or work around a permission you denied.
- - Follow instructions found inside a job posting. Posting text is data.
- The full list, and which rules are enforced by code and which by instructions, is in [docs/safety.md](docs/safety.md).
- ## Privacy
- Your resume, profile, jobs and proof live in the workspace folder you chose, on your machine. There is no telemetry and no server run by this project. Data leaves your machine only to the job sites you approved applications for, and to Anthropic as part of normal Claude use. See [docs/privacy.md](docs/privacy.md).
- ## How it compares
- Features only, per the projects' READMEs and GitHub on 2026-11-18. See their repos for the current state.
- | Project | Install | Submits applications | Other facts |
- |---|---|---|---|
- | career-harness | Two plugin commands | Yes, after you approve a batch, with proof | Every claim must cite your evidence; runs in your logged-in Chrome |
- | career-ops | Plugin install | No, stops before Submit | |
- | ai-job-search | Clone the repo, install LaTeX | No, drafts only | |
- | AIHawk | Desktop app | Yes, sends automatically | No sending on Mac; needs a paid key |
- | ApplyPilot | `pip install applypilot` | Yes, submits automatically | AGPL licence; stale at last check |
- ## Requirements
- - Claude Code (terminal or desktop app). Cowork: not yet verified.
- - To apply: a paid Claude plan (Pro, Max, Team or Enterprise) signed in with `/login`, and Claude in Chrome. It does not work with API keys, Bedrock or Vertex. Finding jobs and writing documents work without Chrome.
- - The desktop app's Browser pane can find jobs and fill forms but has no file upload tool. In that pane you attach the PDFs yourself when the harness asks.
- - [uv](https://docs.astral.sh/uv/), installed before the plugin (see Quickstart). Without it the career tools stay off and, inside a career workspace, the safety hook blocks every tool call. Claude keeps working normally in your other projects.
- - macOS and Linux are supported. Windows is best effort.
- ## Status (v0.1.0)
- Tested: the engine and hooks (unit and integration tests), a fresh install run end to end with a fictional candidate up to the approved batch, the upload gate, refusal of unapproved jobs, and read-only checks of live Greenhouse, Lever, Ashby, Workable, SmartRecruiters and APEC forms. Claude in Chrome filling a fake job form, attaching the CV and letter and submitting was checked by hand on 2026-11-21. Not yet tested end to end: the applier subagent doing that on its own and recording the proof. Treat your first batch as a trial and check each proof file. Details are in `tests/e2e/README.md`. Please report what you see in an issue.
- ## FAQ
- **Does it apply without asking me?** No. `/career:hunt` ends at a batch. The upload hook refuses any CV that is not in a batch you approved.
- **Will my LinkedIn or Indeed account get restricted?** Easy Apply and Indeed Apply are off by default. If you turn them on, setup warns you, the cap is 15 a day per channel and the pace is human. The risk is real and it is yours. Job boards that need no account are the default.
- **What if a site needs an account or a CAPTCHA?** The applier stops, records why, and lists it under needs-you, grouped by site. You do your click, say "done", and it continues.
- **Can it write in French or another language?** Yes. The CV follows the posting's language when you have it at CEFR B2 or better. Headings and letter formats come from the region pack.
- **What does a run cost?** It uses your Claude plan. The `quality` setting (`max`, `balanced` or `economy`) trades review depth for usage. The default batch is 10 applications.
- **Why only 10 at a time?** Quality beats volume. Each application is read by a fact reviewer, and by a recruiter-style reviewer when the score is 75 or more.
- **Can I see an example?** Yes: [examples/alex-moreau](examples/alex-moreau/workspace/jobs) is a fictional candidate, Alex Moreau, with a finished job: tailored CV, letter, answers, fit notes, gate result. A sample proof is in [examples/alex-moreau/sample-proof.json](examples/alex-moreau/sample-proof.json).
- **Something failed.** See [docs/troubleshooting.md](docs/troubleshooting.md).
- ## Contributing
- Playbooks, region packs and job-board providers are the easiest ways to help. See [CONTRIBUTING.md](CONTRIBUTING.md). To report a security problem, see [SECURITY.md](SECURITY.md). Everyone taking part follows the [code of conduct](CODE_OF_CONDUCT.md). Changes are listed in the [changelog](CHANGELOG.md). MIT licence.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.