Documentation
¶
Overview ¶
Command freehire is a debug CLI for freehire.me's public jobs API.
go run ./cmd/freehire search --q golang --work-mode remote --reality fresh go run ./cmd/freehire search --company-slug stripe --seniority staff go run ./cmd/freehire search --cities London --posted-within-days 7 --sort posted_at go run ./cmd/freehire search --skills go,kubernetes --skills-mode and go run ./cmd/freehire search --countries de --source-exclude adzuna go run ./cmd/freehire facets --q golang --facets skills,countries go run ./cmd/freehire facets --seniority senior --disjunctive go run ./cmd/freehire companies --q adria go run ./cmd/freehire companies --collections yc --yc-flags top_company go run ./cmd/freehire company --company-slug stripe go run ./cmd/freehire cities --q lond --country gb go run ./cmd/freehire detail --slug staff-software-engineer-link-stripe-32iy7vks
Every filter runs server-side, and every flag maps to one upstream query parameter of the same name. Paging is --limit/--offset, as upstream declares it, rather than a page number.
Two upstream behaviours make a wrong filter hard to spot. A wrong VALUE matches nothing and is not an error, so a zero-result search usually means a bad slug: resolve one with the facets, companies, or cities subcommand. A wrong PARAMETER NAME is dropped and the whole catalogue comes back, which this CLI reports as an error rather than printing as a result. See internal/provider/freehire/openapi.yaml for the filter grammar and the geography OR-group.