> ## Documentation Index
> Fetch the complete documentation index at: https://jobo.world/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI

> Search jobs, stream the feed, and look up companies from a terminal, with an Agent Skill that teaches coding agents to use it.

`jobo` is a command-line client for the Jobo API. Every search filter is a flag, the feed streams as JSONL with a resumable cursor, and output is a table in a terminal and JSON when piped.

> [!NOTE]
>
> The CLI is built and tested but not on npm yet, so `npm install -g jobo-cli` does not resolve today.

For what all connectors share, see the [connectors overview](https://jobo.world/docs/connectors/overview.md).

***

## Install and authenticate

```bash theme={null}
npm install -g jobo-cli
jobo auth
```

The CLI needs Node 20 or later. `jobo auth` prompts for the key without echoing it, checks it with a request that never uses credits, and saves it to a file only you can read. `JOBO_API_KEY` takes precedence when set, and `--api-key` on any command beats both.

```bash theme={null}
jobo auth --show    # where the key is stored and which one is in use, masked
jobo logout         # remove the saved key
```

***

## Commands

| Command | What it does | Billed |
| - | - | - |
| `jobo search [query]` | Filtered search | Per job returned |
| `jobo job <id>` | One listing | Free |
| `jobo feed` | The job feed as JSONL; needs `--max N` or `--all` | Per new job |
| `jobo expired` | IDs of recently expired jobs | Free |
| `jobo company <id>` | One company profile | Free |
| `jobo companies <query>` | Company name or domain to company ids | Free |
| `jobo geocode <location>` | A place name to coordinates | \$0.001 per lookup |
| `jobo filters [facet] [query]` | Valid filter values, with live job counts | Free |
| `jobo occupations` | The occupation taxonomy | Free |
| `jobo usage` | The key in use and its rate-limit position | Free |
| `jobo mcp [client]` | How to connect the [MCP server](https://jobo.world/docs/connectors/mcp.md) to an AI client | Free |
| `jobo skill install` | Install the Agent Skill | Free |

Run `jobo <command> --help` for every flag.

### Search

```bash theme={null}
jobo search "python engineer" --work-model remote --experience-level senior,lead --posted-after 7d
jobo search --skills Python --exclude-skills PHP --min-salary-usd 120000 --page-size 5
jobo search --companies stripe.com --json
```

* Every filter of [`POST /api/jobs/search`](https://jobo.world/docs/api-reference/jobs/search-jobs) is a flag: the filter's name in kebab-case, with an `--exclude-` twin where the API has one.
* `--page-size` defaults to 10. `--max N` walks whole pages up to N jobs and never past it.
* Date flags take an ISO 8601 timestamp or a relative time such as `24h`, `7d`, or `2w`.
* Use `jobo filters` to list the valid values for a flag.

### Feed

```bash theme={null}
jobo feed --max 500 --sources greenhouse,lever --work-models remote > jobs.jsonl
jobo feed --all --cursor-file feed.cursor > jobs.jsonl
```

The feed streams every matching job and bills each one that is [new to you](https://jobo.world/docs/billing.md#unique-jobs-on-feed-export-and-outbound), so it won't start without `--max N` or `--all`. The cursor is written after every batch; pass `--cursor` or `--cursor-file` to resume a scan that stopped.

***

## Output

Data goes to stdout; costs, progress, cursors, and errors go to stderr, so piping stays clean. `--json`, `--jsonl`, `--csv`, and `--table` choose the format, `--fields` chooses the columns, and `-o FILE` writes to a file (it refuses to overwrite without `--overwrite`).

| Exit code | Meaning |
| - | - |
| 0 | OK |
| 1 | Error |
| 2 | Usage |
| 3 | Authentication |
| 4 | Insufficient credits |
| 5 | Rate limited |
| 6 | Not found |
| 7 | API unreachable |
| 8 | Feed cursor must restart |

***

## Agent Skill

The CLI ships an Agent Skill, a `SKILL.md` folder that teaches a coding agent the commands, how to find valid filter values, and the cost rules it must respect.

```bash theme={null}
jobo skill install               # ~/.claude/skills/jobo-job-search
jobo skill install --project     # ./.claude/skills/jobo-job-search
jobo skill install --dir PATH    # PATH/jobo-job-search
jobo skill show >> AGENTS.md     # for agents that read one instructions file
```

***

## Sandbox keys

A [sandbox key](https://jobo.world/docs/sandbox.md) serves `search`, `job`, and `company`. Every other command answers that it isn't available with a sandbox key.

***

> [card] [Related: MCP server](https://jobo.world/docs/connectors/mcp.md)
>
> An agent that supports MCP can search Jobo directly, with OAuth sign-in instead of an API key. `jobo mcp <client>` prints the setup.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.