// freehire on the command line
Search and track
from the terminal.
freehire is a small CLI over the same job API the
site runs on — so an AI agent or a script can search and open
jobs, then track applications and notes without a browser. (You still apply on the employer's
site; the CLI records that you did.)
# install — no Go needed curl -fsSL https://freehire.dev/install.sh | sh # authenticate once (key from /my/api-keys) freehire auth login --token fhk_… # search freehire search "golang" --remote --region eu
// commands
Discover
- freehire search <query>
- List matching jobs (add --remote, --region, --company).
- freehire job <slug>
- Show a job's full content.
- freehire company <slug>
- Show a company and its open jobs.
Track applications & notes
- freehire apply <slug>
- Mark a job applied for your account.
- freehire save <slug>
- Bookmark a job (unsave to remove).
- freehire stage <slug> <stage>
- Set the application stage.
- freehire note <slug> <text>
- Attach a free-text note.
- freehire my --filter applied
- Your tracked jobs (all|viewed|saved|applied).
Everything you save, apply to and stage shows up on your My jobs board. stage takes a controlled value: applied → screening → responded → interview → offer → accepted, plus rejected / withdrawn. For scripts and agents, add --json for the raw API payload; results go to stdout,
errors to stderr, and a non-zero exit code signals failure. The same endpoints are documented in the API reference.
// moderators
With the moderator role you can author postings:
freehire jobs add --url <url> --title "Senior Go Developer" --company Acme freehire jobs edit <slug> --title "Staff Go Developer"
Free and open source — no tracking, no lock-in. Read every line on GitHub ↗.