aranculleton/last-job-search / .agents/skills/freehire-search
freehire-search
VerifiedUse this skill to search live software / tech / data / engineering job listings across many countries and markets (and remote) via the freehire.me aggregator's public API, or to look up a specific posting. It aggregates roles from ~50 ATS platforms into one schema, so a single skill covers many markets - but its faceted filtering (skills, category, seniority) is tuned tech-first, so scope triggers to technical roles. Trigger phrases: find a tech job, software job search, developer jobs, engineering vacancies, data/ML jobs, DevOps roles, remote developer jobs, "are there any <tech role> jobs in <place>", look up this freehire job posting.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.4 KB |
| cli/README.md | markdown | 4.0 KB |
| cli/package.json | manifest | 612 B |
| cli/src/cli.ts | script | 10.0 KB |
| cli/src/commands/detail.ts | script | 2.3 KB |
| cli/src/commands/search.ts | script | 6.1 KB |
| cli/src/helpers.ts | script | 7.7 KB |
| cli/tests/cli-flag-validation.test.ts | script | 5.2 KB |
| cli/tests/commands.test.ts | script | 8.3 KB |
| cli/tests/helpers.ts | script | 1.0 KB |
| cli/tests/parsing.test.ts | script | 3.4 KB |
| cli/tests/request-timeout.test.ts | script | 957 B |
| cli/tests/retry-backoff.test.ts | script | 2.4 KB |
| cli/tsconfig.json | config | 305 B |
| url-reference.md | markdown | 7.0 KB |
cli/tests/retry-backoff.test.ts
View on GitHubimport { afterEach, describe, expect, test } from "bun:test";
import { apiGet } from "../src/helpers";
// The portal contract requires backoff on 429/5xx. These tests pin the retry
// loop offline: a stubbed fetch counts attempts, and a stubbed setTimeout
// fires immediately so the exhaustion case does not sleep through the real
// 500ms -> 8s backoff schedule. apiGet's documented graceful-degradation
// contract (connection failures fail fast, no retry) is pinned too.
const originalFetch = globalThis.fetch;
const originalSetTimeout = globalThis.setTimeout;
afterEach(() => {
globalThis.fetch = originalFetch;
globalThis.setTimeout = originalSetTimeout;
});
function instantTimers() {
globalThis.setTimeout = ((fn: () => void) =>
originalSetTimeout(fn, 0)) as unknown as typeof setTimeout;
}
function stubFetch(responses: Array<() => Response>): { calls: number } {
const state = { calls: 0 };
globalThis.fetch = (async () => {
const i = Math.min(state.calls, responses.length - 1);
state.calls++;
return responses[i]();
}) as unknown as typeof fetch;
return state;
}
describe("apiGet retry/backoff", () => {
test("retries a 429 and succeeds on the next attempt", async () => {
instantTimers();
const state = stubFetch([
() => new Response("", { status: 429 }),
() => new Response('{"data":[]}', { status: 200 }),
]);
const envelope = await apiGet<unknown[]>("/x");
expect(envelope).not.toBeNull();
expect(state.calls).toBe(2);
});
test("returns the documented null on 404 without retrying", async () => {
const state = stubFetch([() => new Response("", { status: 404 })]);
const envelope = await apiGet("/x");
expect(envelope).toBeNull();
expect(state.calls).toBe(1);
});
test("gives up after the initial attempt plus six retries on persistent 5xx", async () => {
instantTimers();
const state = stubFetch([() => new Response("", { status: 500 })]);
await expect(apiGet("/x")).rejects.toThrow(/500/);
expect(state.calls).toBe(7);
});
test("fails fast on a connection error - no retry, per the graceful-degradation contract", async () => {
const state = { calls: 0 };
globalThis.fetch = (async () => {
state.calls++;
throw new TypeError("Unable to connect");
}) as unknown as typeof fetch;
await expect(apiGet("/x")).rejects.toThrow(/could not reach the freehire API/);
expect(state.calls).toBe(1);
});
});
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |