freehire-tailor-cv

Tailoring a CV to a vacancy (beta)

Needs a key: freehire auth login --token fhk_… (or FREEHIRE_TOKEN). These commands act as the user whose key you signed in with, the same as every other command.

A tailored CV is a copy of the candidate's base CV bound to one vacancy. Start one — or reopen the one that exists — with the vacancy's slug, and the whole cycle runs from here:

freehire cv tailor <job-slug>         # create/reopen the copy; prints the CV id
freehire cv list                      # the tailored CVs that already exist
freehire cv context <id>              # the fit analysis to reframe toward (JSON)
freehire cv get <id>                  # the current CV document (JSON)
freehire cv edit <id> --set 'path=value'  # one edit; --ops '<json>' or stdin for several
freehire cv render <id> --out cv.pdf  # download the ATS PDF to inspect

cv tailor is idempotent per vacancy: running it twice for the same slug returns the same copy, so it is safe to start with when you do not know whether one exists. It spends an AI credit the first time it creates the copy (402 when the balance will not cover it) and 409s when the candidate has no résumé on the site to seed a base CV from — tell them to upload one; you cannot do it for them.

The id is opaque: read it from cv tailor or cv list, do not construct or guess one. An id that is not the caller's own comes back as "not found" — the same answer as one that never existed. The workspace URL on the site (/tailor/<job>?cv=<id>) carries the same id if the candidate would rather paste it.

Editing by path

An edit is a kind (set, insert, remove, move) and a path into the document. Paths reach everything: summary, experience[2].bullets[1], experience[0].stack[0], skills[0].items[3], education[1].degree, certifications[0].issuer, style.font_size. Indices are 0-based, counted over what cv get returned.

freehire cv edit <id> --set 'summary=Senior backend engineer…'
freehire cv edit <id> --set 'experience[0].bullets[1]=Cut p99 latency 40%' --evidence <atom-id>
freehire cv edit <id> --insert 'experience[0].bullets[0]=Ran the migration' --evidence <atom-id>
freehire cv edit <id> --remove 'skills[2]'
freehire cv edit <id> --ops '[{"kind":"move","path":"experience[0].bullets[2]","to":0}]'