freehire

command
v0.17.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 25, 2026 License: MIT Imports: 13 Imported by: 0

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.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
⌂ 换网址