freehire-job-searchlisted

# Finding jobs on freehire `freehire` is a single static binary over the [freehire.me](https://freehire.me) job API. It searches, filters and opens IT jobs without a browser. Every command supports `--json` for a raw, faithful API payload (pipe to `jq`). Needs a key: `freehire auth login --token fhk_…` (or `FREEHIRE_TOKEN`). A 401 means "run `freehire auth login`". ## The loop **0. Read the person's own profile before asking them anything.** ```bash freehire profile # roles, skills, skills to avoid, geography, CV freehire --json profile | jq '.skills, .cv.total_years' ``` They have already told freehire which roles and skills they want, which they would rather avoid, and where and how they will work. Start from that and say what you searched on; ask only about what it does not answer. It returns `null` data when they have saved none — then point them at `https://freehire.me/my/profile` rather than collecting the same answers in the conversation, because what they save there also drives their recommendations and alerts. Contact details are never included. **1. Discover what you can filter by — before guessing values.** ```bash freehire facets # every filter's live values + counts, and skills freehire facets --category backend # values relevant to a slice (e.g. backend skills) freehire --json facets | jq '.facets.skills' # canonical skill slugs with demand ``` `facets` is the vocabulary source of truth: it returns each fa