Coding agent documentation index Fetch the complete documentation index at: https://docs.worklittle.com/docs-agent-manifest.json Use this file to discover all available pages before exploring further.

Agent Quickstart

Install agent skills, create an API key, then make a first Jobs API call. Official clients: cURL, CLI, Python, and TypeScript.

Coding agents should fetch https://docs.worklittle.com/agent-onboarding/SKILL.md. This page is the same onboarding for people reading in a browser.

Call the API

cURL

#### 1. Install agent skills

Run this in the project the agent is working in:

npx skills add https://docs.worklittle.com

Or npx skills add worklittle/agent-skills. Full list: Agent skills.

#### 2. Create an API key

Sign in to Worklittle Business, open API keys, and choose Create API key. Copy the sk-wl-api01-... secret once.

Give the key jobs:read. If paid routes return 402 Payment Required, open Billing and fix billing before retrying.

#### 3. Set your API key

Export the key as an environment variable. The SDK and CLI read WORKLITTLE_API_KEY automatically.

export WORKLITTLE_API_KEY="sk-wl-api01-..."

#### 4. Search jobs

Send a GET request to https://api.worklittle.com. Any language with HTTPS can do the same. Schema: OpenAPI.

curl -s "https://api.worklittle.com/jobs?q=software+engineer&limit=5" \
  -H "Authorization: Bearer $WORKLITTLE_API_KEY"

Output

{
  "data": [
    {
      "job_id": "…",
      "title": "Software Engineer",
      "company_name": "Example Co",
      "location": "Remote"
    }
  ],
  "meta": { "next_cursor": "…" }
}

CLI

#### 1. Install agent skills

Run this in the project the agent is working in:

npx skills add https://docs.worklittle.com

Or npx skills add worklittle/agent-skills. Full list: Agent skills.

#### 2. Create an API key

Sign in to Worklittle Business, open API keys, and choose Create API key. Copy the sk-wl-api01-... secret once.

Give the key jobs:read. If paid routes return 402 Payment Required, open Billing and fix billing before retrying.

#### 3. Install the CLI

brew install worklittle/tap/worklittle

Other install options: CLI.

#### 4. Set your API key

Export the key as an environment variable. The SDK and CLI read WORKLITTLE_API_KEY automatically.

export WORKLITTLE_API_KEY="sk-wl-api01-..."

#### 5. Run a command

worklittle jobs search --q="software engineer" --limit 5 --pretty

Output

{
  "data": [
    {
      "job_id": "…",
      "title": "Software Engineer",
      "company_name": "Example Co",
      "location": "Remote"
    }
  ],
  "meta": { "next_cursor": "…" }
}

Python

#### 1. Install agent skills

Run this in the project the agent is working in:

npx skills add https://docs.worklittle.com

Or npx skills add worklittle/agent-skills. Full list: Agent skills.

#### 2. Create an API key

Sign in to Worklittle Business, open API keys, and choose Create API key. Copy the sk-wl-api01-... secret once.

Give the key jobs:read. If paid routes return 402 Payment Required, open Billing and fix billing before retrying.

#### 3. Set your API key

Export the key as an environment variable. The SDK and CLI read WORKLITTLE_API_KEY automatically.

export WORKLITTLE_API_KEY="sk-wl-api01-..."

#### 4. Create a project and install the SDK

The Python SDK is not on PyPI yet. From the Worklittle monorepo:

cd packages/sdk-python
pip install -e .

Full install notes: Python SDK.

#### 5. Create your code

Create a file called quickstart.py:

from worklittle import Worklittle

wl = Worklittle()
page = wl.jobs.search(q="software engineer", limit=5)
print(page)

#### 6. Run your code

python quickstart.py

Output

{
  "data": [
    {
      "job_id": "…",
      "title": "Software Engineer",
      "company_name": "Example Co",
      "location": "Remote"
    }
  ],
  "meta": { "next_cursor": "…" }
}

TypeScript

#### 1. Install agent skills

Run this in the project the agent is working in:

npx skills add https://docs.worklittle.com

Or npx skills add worklittle/agent-skills. Full list: Agent skills.

#### 2. Create an API key

Sign in to Worklittle Business, open API keys, and choose Create API key. Copy the sk-wl-api01-... secret once.

Give the key jobs:read. If paid routes return 402 Payment Required, open Billing and fix billing before retrying.

#### 3. Set your API key

Export the key as an environment variable. The SDK and CLI read WORKLITTLE_API_KEY automatically.

export WORKLITTLE_API_KEY="sk-wl-api01-..."

#### 4. Create a project and install the SDK

@worklittle/sdk is not on npm yet. From the Worklittle monorepo:

cd packages/sdk-js
npm install && npm run build
npm pack

Then install the packed tarball in your project, or npm install /path/to/packages/sdk-js after build. Full notes: TypeScript SDK.

#### 5. Create your code

Create a file called quickstart.ts:

import { createWorklittle } from "@worklittle/sdk";

const wl = createWorklittle();
const page = await wl.jobs.search({ q: "software engineer", limit: 5 });
console.log(page);

#### 6. Run your code

npx tsx quickstart.ts

Output

{
  "data": [
    {
      "job_id": "…",
      "title": "Software Engineer",
      "company_name": "Example Co",
      "location": "Remote"
    }
  ],
  "meta": { "next_cursor": "…" }
}

Decide Jobs vs Business

Infer this from the user's request. Do not make them choose a product tree.

| If the user wants… | Product | Next docs |
| --- | --- | --- |
| Search the market, match roles, maps, public boards | **Jobs** | [Jobs overview](/jobs/get-started/overview), [Job search assistant](/use-cases/job-search-assistant) |
| Apply, Apply with AI, resumes, cover letters | **Jobs** | [Apply for jobs](/jobs/api/apply-for-jobs), [Apply with AI](/use-cases/apply-with-ai) |
| Post openings, ATS pipeline, interviews, offers | **Business** | [Business overview](/business/get-started/overview), [ATS automation](/use-cases/ats-automation) |
| Org, employees, surveys, HR docs, attendance | **Business** | [Org operations](/use-cases/org-ops) |
| Webhooks for hiring events | **Business** | [Webhooks](/business/webhooks/overview) |
| Unclear, or both | Start Jobs for market data, Business for their own hiring workspace | [Capability map](/use-cases/capability-map) |

Rule of thumb: data about every employer is Jobs. Data about this employer is Business. One sk-wl-api01- key can hold scopes for both.

Jobs path

Use this when the user is a job seeker, a job board, or an agent searching the market.

| Goal | Start here |
| --- | --- |
| Live tools in Cursor, Claude, or VS Code | [MCP](/jobs/mcp) — `https://mcp.worklittle.com` |
| Search and filters | [Search jobs](/jobs/api/search-jobs) |
| Apply and documents | [Apply for jobs](/jobs/api/apply-for-jobs) |
| First curl search | [Jobs Quickstart](/jobs/get-started/quickstart) |
| TypeScript / Python / CLI | [Libraries](/jobs/libraries/overview) |

Business path

Use this when the user is hiring or running HR in Worklittle.

| Goal | Start here |
| --- | --- |
| Live tools | [MCP](/business/mcp) — same `https://mcp.worklittle.com` endpoint |
| Publish a job | [Post a job](/business/api/post-a-job) |
| Pipeline | [Manage candidates](/business/api/manage-candidates) |
| First curl list | [Business Quickstart](/business/get-started/quickstart) |
| TypeScript / Python / CLI | [Libraries](/business/libraries/overview) |

For agents

Fetch the skill file directly:

https://docs.worklittle.com/agent-onboarding/SKILL.md

Then route from the user's goal using the Jobs vs Business table above. Do not invent MCP tool names or query parameters. Discovery: llms.txt, docs-agent-manifest.json, or append .md to a docs URL. Architecture after onboarding: Agent patterns.