// HireAll on the command line
Search and track
from the terminal.
HireAll is a small CLI — and an MCP server — over the
same job API the site runs on. One API key lets an AI agent or a script search and open jobs, track
applications, work through your application mail and tailor a CV to a vacancy — all without a browser. (You still apply on the employer's site;
the CLI records that you did.)
Not on the terminal? Every way to connect an agent — MCP hosts, ChatGPT, and your own client.
# install — no Go needed curl -fsSL https://freehire.me/install.sh | sh # authenticate once (key from /my/api-keys) HireAll auth login --token fhk_… # discover the market, then search HireAll facets HireAll search "golang" --remote --region eu
// commands
Discover
- HireAll facets
- Every filter's live values + counts — the vocabulary to filter by.
- HireAll market-fit --skills go,react
- How much of the live market your skills cover, and the gaps.
- HireAll search <query>
- List matching jobs (add --remote, --region, --company).
- HireAll job <slug>
- Show a job's full content.
- HireAll company <slug>
- Show a company and its open jobs.
Track applications & notes
- HireAll apply <slug>
- Mark a job applied for your account.
- HireAll save <slug>
- Bookmark a job (unsave to remove).
- HireAll stage <slug> <stage>
- Set the application stage.
- HireAll note <slug> <text>
- Attach a free-text note.
- HireAll my --filter applied
- Your tracked jobs (all|viewed|saved|applied).
- HireAll profile
- Your saved search profile — skills, seniority, regions.
Application mail
- HireAll inbox push --file mail.json
- Upload a batch your own client fetched (keyed by Message-ID, so a re-sync updates instead of duplicating).
- HireAll inbox list --unclassified --body
- The agent's work queue: unjudged mail with bodies inline, and nothing gets marked read.
- HireAll inbox triage <id> <signal>
- Record what a message is; a confident verdict moves the application forward.
- HireAll inbox list --link suggested
- Proposed links awaiting your word — inbox confirm / inbox reject.
- HireAll inbox list --link unlinked
- Mail with no application to attach to — inbox application records one from the message.
Contribute & moderate
- HireAll contribute <url>
- Hand HireAll a job link; a board we don't track yet gets added and crawled.
- HireAll contributions
- The boards you've contributed and their state.
- HireAll submissions
- Jobs you submitted; the review queue with pending/approve/reject (moderator).
- HireAll jobs add | edit <slug>
- Create or edit a job posting (moderator).
Start from HireAll facets — it lists every filter's live
values so search and market-fit use real values, not guesses. Everything you
save, apply to and stage shows up on your Tracking board. stage takes a controlled value: preparing → applied → screening → responded → interview → offer → accepted, plus rejected / withdrawn.
Tailor a CV to a vacancy
After a match analysis, reframe your CV toward one job — grounded in what you actually did, never
fabricated — then export an ATS-ready PDF. cv context is the honest part: it splits the job's requirements into the ones your history already covers but
buries (reframe those) and the ones it doesn't (ask, don't invent), so an agent editing your CV
knows which is which.
HireAll cv context <id> # the match analysis to reframe toward HireAll cv get <id> # the CV document as JSON HireAll cv edit <id> --set … # one edit by path (--ops for a batch) HireAll cv render <id> --out cv.pdf
// mcp
Same key, any AI host
HireAll-mcp exposes the same search, market-fit and
tracking tools over the Model Context Protocol — so Claude Desktop, Claude Code or any MCP host can drive HireAll directly. It runs via npx; no global install.
It shares the CLI's credentials: if you've run HireAll auth login, omit env and it reads ~/.HireAll/creds.json.
{
"mcpServers": {
"HireAll": {
"command": "npx",
"args": ["-y", "HireAll-mcp"],
"env": { "HIREALL_TOKEN": "fhk_…" }
}
}
}// for ai agents
Five skills, one per job
Each agent skill is named for the task, not the tool, so a host loads what the question needs instead of the whole surface. Drop them into a Claude Code (or compatible) skills directory — or install the plugin and get the slash commands too.
/plugin marketplace add strelov1/freehire-cli /plugin install HireAll@HireAll-cli
Every command takes --json for the raw API
payload — results to stdout, errors to stderr, non-zero exit on failure. The same
endpoints are in the API reference.
- /job-search HireAll-job-search
- Read the saved profile, ground every filter in facets, search, and shortlist.
- /track-applications HireAll-track-applications
- Where each application stands, stage moves, and reporting one that never answered.
- /market-fit HireAll-market-fit
- Score a stack against live vacancy demand and put a number on every gap.
- /tailor-cv HireAll-tailor-cv
- Reframe a CV toward one vacancy — every claim cited, nothing invented.
- /triage-inbox HireAll-mail-triage
- Push a mail batch, judge each message, and drain the two link queues.
// moderators
With the moderator role you can author postings:
HireAll jobs add --url <url> --title "Senior Go Developer" --company Acme HireAll jobs edit <slug> --title "Staff Go Developer"
Free and open source — no tracking, no lock-in. Read every line of the CLI ↗ and the MCP server ↗ on GitHub.