mirror of https://github.com/MadsLorentzen/ai-job-search.git synced 2026-09-17 08:36:25 +00:00

Files

T

Mads LorentzenandClaude Opus 4.8 a68028bc54 fix(cli): pin @types/bun and @bunli/* to concrete versions to stop CI type-drift (#226 )

CI runs `bun install` (not --frozen-lockfile) and the CLIs' package.json
pinned @types/bun, @bunli/core, and @bunli/utils to "latest", so each fresh
install could resolve a different version than the lockfile. When a "latest"
bun-types resolved that didn't satisfy the tsconfig (lib: ["ESNext"] with no
DOM, types: ["bun-types"] as the only source of Response/URL/fetch globals),
`bun run typecheck` failed across every .ts file - a transient red on PRs that
never touched TypeScript (observed on #207, which changes only SKILL.md).

Pin the three previously-floating dev/framework deps to the versions the
lockfiles already resolve, so behavior is unchanged and the drift class is
gone:
- @types/bun: latest -> 1.3.14  (all 6 CLIs)
- @bunli/core:  latest -> 0.9.1  (jobbank, jobdanmark, jobindex, jobnet)
- @bunli/utils: latest -> 0.6.0  (jobbank, jobdanmark, jobindex, jobnet)

The ^-ranged deps (node-html-parser, zod, typescript) are left as-is; they are
semver-guarded and were not the cause. No lockfiles committed (bun.lock stays
gitignored per existing policy). Verified: all 6 CLIs install and `bun run
typecheck` clean with the pins.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-22 17:18:46 +02:00

src

fix(cli): catch unhandled promise rejections in self-contained CLIs (#203 )

2026-07-20 21:54:10 +02:00

tests

fix(portals): add a 15s request timeout to every board fetch (#197 )

2026-07-20 20:19:27 +02:00

package.json

fix(cli): pin @types/bun and @bunli/* to concrete versions to stop CI type-drift (#226 )

2026-07-22 17:18:46 +02:00

README.md

Add freehire-search: country-agnostic freehire.dev aggregator skill (#85 )

2026-07-09 06:04:35 +02:00

tsconfig.json

Add freehire-search: country-agnostic freehire.dev aggregator skill (#85 )

2026-07-09 06:04:35 +02:00

README.md

freehire-cli

CLI for searching the freehire.dev job aggregator across many markets (tech-focused), via its public JSON API.

Data source: freehire.dev REST API (/api/v1/jobs/search, /api/v1/jobs/facets, /api/v1/jobs/{slug}). Authentication: None required — reads are public (only tracking mutations need a key, and those are out of scope here). Dependencies: None (plain bun + fetch). bun install is optional and only pulls dev type defs.

Hosted-service dependency. This skill talks to freehire.dev, a personal project maintained on a best-effort basis with no formal SLA. If the API is unreachable the CLI exits non-zero with a clear error rather than hanging, so an outage degrades gracefully instead of breaking the caller. Point FREEHIRE_API_URL at a self-hosted freehire backend to swap the source.

Installation

cd .agents/skills/freehire-search/cli
bun install   # optional — only installs TypeScript dev types

The CLI runs without any install because it has zero runtime dependencies.

Self-hosting / base URL

The base URL defaults to https://freehire.dev and is overridable with an env var:

FREEHIRE_API_URL=http://localhost:8080 bun run src/cli.ts search -q "go"

The freehire backend is MIT-licensed and stands up with one command via Docker Compose (make up → API on :8080, same /api/v1/... paths).

Commands

Command	Description
`search`	Search jobs by keyword and facet filters
`detail`	Fetch full detail for a single job by its slug

search accepts --format json|table|plain (default json); detail accepts --format json|plain. All errors are written to stderr as { "error": "...", "code": "..." } with exit code 1.

Quick examples

# Senior backend roles, table view
bun run src/cli.ts search -q "backend engineer" --seniority senior --limit 10 --format table

# Remote React roles in the EU
bun run src/cli.ts search -q "react" --remote remote --region eu --format table

# DevOps roles in Germany posted in the last 14 days
bun run src/cli.ts search --category devops --country DE --jobage 14 --format table

# Full detail for one job (slug from a search result's id)
bun run src/cli.ts detail golang-zensar-2bxu6dxm --format plain

See ../SKILL.md for the full flag reference and the hosted-dependency note.

Search flags

Flag	Alias	Description
`--query`	`-q`	Keywords (title / skill / role). Full-text; optional.
`--jobage`		Posted within N days (`posted_within_days`).
`--page`		1-indexed page. Default 1.
`--limit`	`-n`	Results per page (API limit). Default 25.
`--region`		Macro-region(s), comma = OR (e.g. `eu,us`).
`--country`		ISO-3166 alpha-2 code(s).
`--city`		City name(s).
`--seniority`		Seniority level(s).
`--category`		Role category(ies).
`--skill`		Canonical skill(s).
`--company`		Company slug.
`--remote`		`remote` \| `hybrid` \| `onsite` (`work_mode`).
`--facet`		Any other facet as `key=value` (repeatable).
`--format`		`json` \| `table` \| `plain`.

Facet values come from freehire's controlled vocabularies. Discover the live values (with counts) for a market at /api/v1/jobs/facets, or narrow it, e.g. https://freehire.dev/api/v1/jobs/facets?q=react.