freehire is an open-source job search engine that collects listings directly from company career pages, normalizes and removes duplicates, and makes them searchable. Job seekers use it to find current roles through the hosted service, a self-hosted installation, its API, CLI, or Telegram digests.
Borrowing it
Nothing to install: this file belongs to strelov1/freehire. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/strelov1/freehire/main/AGENTS.mdgit clone --depth 1 https://github.com/strelov1/freehireWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/strelov1/freehire/agents-md)<a href="https://agentmods.dev/instructions/strelov1/freehire/agents-md"><img src="https://agentmods.dev/badge/instructions/strelov1/freehire/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/strelov1/freehire/agents-md"><img src="https://agentmods.dev/badge/instructions/strelov1/freehire/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.26221 | $0.26221 |
| Opus 5.5 | $0.10488 | $0.10488 |
| Sonnet 5.5 | $0.05244 | $0.05244 |
| Haiku 4.5 | $0.02622 | $0.02622 |
Grade C, and why
freehire AGENTS.md scanned grade C with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Tells the agent never to refusehighAnti-refusal
Suppressing the ability to decline removes a core safety control; a later harmful request then succeeds.
- **LLM spend attribution:** every model call made for a signed-in user goes out on that user's OWN gateway credential (`internal/ai/llmkey` — minted lazily on first use, never shown to them) and carries a `feature:` tag How it starts
The opening of the file, as written. The whole thing — 310 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
Guidance for AI agents working in this repository.
Working principles
- No overengineering, and no MVP shortcuts. Hold the middle path: don't build infrastructure before there's a concrete need (note the seam for later instead), and don't ship quick-and-dirty or "for now" hacks. Build each feature correctly and idiomatically — neither gold-plated nor a placeholder.
- MVP stage — keep the architecture fluid. The current structure is not load-bearing legacy. When a new feature doesn't fit cleanly, prefer reshaping the affected part over bolting on an awkward special case.
- Surgical changes. Clean up what your change orphaned; leave pre-existing dead code alone. Prefer a library's intended API over a clever shim.
- English only. All code, comments, identifiers, docs, and commits.
What this is
freehire (freehire.me) is an open-source IT job aggregator. Many source parsers feed a pipeline that normalizes jobs into one schema, deduplicates them, and enriches them with AI; served over an HTTP API with rich filters, consumed by a SvelteKit app under web/.
Stack: Go + Fiber v2, PostgreSQL, sqlc, Meilisearch, Docker Compose, langchaingo.
Layout
internal/<block>/<pkg>/ — every package sits in exactly one of eleven blocks, and the
blocks form eight layers. A block may import only blocks strictly below it; two blocks
sharing a layer may not see each other in either direction. The substantial packages carry
their own AGENTS.md (see the table below), and each block carries one saying what it is and
what it may reach for.
8. api handlers, middleware, realtime, OG images
7. engage notifications, digests, onboarding, referrals
ingest source adapters, crawl pipeline, link import, manual intake
6. application tracking, stages, the event ledger, mail and calendar
search Meili topology, the drain, saved searches, intent
5. job the posting: identity, facets, wire shape, dedup, ghost signal
4. candidate CV, structured extraction, experience bank, PII, matching
3. ai enrichment, embeddings, assistant, speech, plan limits
identity accounts, auth, profile
2. dict the facet dictionaries and normalisation under them
1. platform db, worker plumbing, outbox, cache, HTTP and LLM transport
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- yesterday Changed · +1 lines · +199 tokens per session 6031739d778a
- 2d ago Changed · -14 lines · -4,075 tokens per session d8ab3adfe7f6
- 3d ago Changed · +3 lines · +775 tokens per session 9266a981fc71
- 4d ago Changed · -1 lines · -51 tokens per session 54912a7cf8ae
- 6d ago Changed · +2 lines · +1,037 tokens per session 6123b4a146d6
- 7d ago Changed · +1 lines · +500 tokens per session a1e1212799e4
- 8d ago Changed · +1 lines · +277 tokens per session 4dfa26e12b11
- 9d ago Changed · +139 tokens per session 86b66afc0ac1
- 11d ago Changed · +3 lines · +493 tokens per session c7df522b7e30
- 12d ago First seen · 314 lines · 26,927 tokens per session scan C 3ffe56ed1c63
freehire AGENTS.md is an instructions file published in the GitHub repository strelov1/freehire (3,382 stars, last pushed yesterday), licensed MIT. It adds 26,221 tokens to every session, about $0.1049 per session on Opus 5.5. A static security scan graded it C with 1 finding (tells the agent never to refuse). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
freehire AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| freehire AGENTS.mdstrelov1/freehire | Instructions file | 3.4k | yesterday | MIT | C | 26,221 | Codex, OpenCode |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | yesterday | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | yesterday | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |