Skip to content
Back to search

jobo-cli

Jobo CLI (jobo-cli) — search live job listings, stream the job feed and look up companies from the terminal. One-way mirror of the Jobo monorepo; PRs are not accepted here.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/JoboAI/jobo-cli with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/JoboAI/jobo-cli'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/joboai--jobo-cli/badge.svg)](/listings/joboai--jobo-cli)

HTML

<a href="/listings/joboai--jobo-cli"><img src="/api/listings/joboai--jobo-cli/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install -g jobo-cli      # installs the `jobo` command
npx jobo-cli --help          # or run it without installing

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 312 lines
  1. # jobo-cli
  2. Command-line client for the [Jobo jobs API](https://jobo.world/docs): search live job listings from
  3. employer career sites and 200+ applicant tracking systems, stream the job feed, and look up companies,
  4. locations and filter values. It ships an [Agent Skill](#agent-skill) that teaches coding agents to use
  5. it, and prints the setup for the hosted [MCP server](#mcp-server).
  6. ```bash
  7. jobo search "data engineer" --location "Berlin, Germany" --work-model remote,hybrid
  8. ```
  9. No runtime dependencies: one package, Node 20 or later.
  10. ## Install
  11. ```bash
  12. npm install -g jobo-cli # installs the `jobo` command
  13. npx jobo-cli --help # or run it without installing
  14. ```
  15. ## Authenticate
  16. Create an API key in the [dashboard](https://enterprise.jobo.world/api-keys) under **Developers → API
  17. Keys** ([sign up](https://enterprise.jobo.world/register) first if you have no account), then:
  18. ```bash
  19. jobo auth # prompts for the key without echoing it
  20. jobo auth --api-key KEY # or pass it
  21. echo "$KEY" | jobo auth # or pipe it
  22. jobo auth --show # where the key is stored and which one is in use, masked
  23. jobo logout # remove the saved key
  24. ```
  25. `jobo auth` checks the key's shape, then verifies it with one call that is never billed, and saves it to
  26. `$XDG_CONFIG_HOME/jobo/config.json` (default `~/.config/jobo/config.json`; `%APPDATA%\jobo\config.json`
  27. on Windows) with mode `0600`. `--no-verify` skips the check.
  28. Which key a command uses, first match wins:
  29. 1. `--api-key KEY` on the command
  30. 2. the `JOBO_API_KEY` environment variable
  31. 3. the saved key
  32. Live keys start with `jbe_live_`. A sandbox key (`jbe_test_`) is free and returns fictional jobs in the
  33. real response shape; it serves `search`, `job` and `company` only.
  34. ## What it costs
  35. Jobo bills per job, not per request. Credits are the wallet's unit: 1,000 credits = $1.00.
  36. | Command | Cost |
  37. | --- | --- |
  38. | `jobo search` | Every job returned: $3.00 per 1,000 jobs (3 credits each) after your plan's included jobs. An empty page is free. |
  39. | `jobo feed` | Every job that is new to you: one you have not received through Feed, Export or Outbound in the last 30 days. Same rate. Jobs you already hold are delivered again at no charge. |
  40. | `jobo geocode` | $0.001 per lookup (1 credit), resolved or not. |
  41. | `jobo job`, `company`, `companies`, `filters`, `occupations`, `expired`, `usage` | Free. |
  42. On the Unlimited plan, Search and Feed have no per-job charge. See [Billing](https://jobo.world/docs/billing).
  43. The CLI is built so a mistake cannot run up a bill:
  44. - `jobo search` fetches one page of 10 unless you ask for more. `--max N` walks whole pages up to N jobs
  45. and stops; there is no unbounded search.
  46. - `jobo feed` refuses to run without `--max N` or `--all`.
  47. - Arguments are validated before anything is sent, and an output file that already exists is refused
  48. before the request, not after it.
  49. - Every billed request prints what it cost on stderr:
  50. ```text
  51. usage: 30 credits ($0.03) charged · wallet 4,970 credits ($4.97)
  52. ```
  53. The wallet must cover a full page before a request runs (`--page-size` jobs for search, `--batch-size`
  54. for the feed), so use a smaller size on a low balance. A `402` is never retried; the error carries the
  55. top-up link.
  56. ## Commands
  57. Every command takes `--help`.
  58. ### `jobo search [query]`
  59. `POST /api/jobs/search`. Billed per job returned.
  60. ```bash
  61. jobo search "python engineer" --work-model remote --experience-level senior,lead --posted-after 7d
  62. jobo search --skills Python --exclude-skills PHP --min-salary-usd 120000 --page-size 5
  63. jobo search --companies stripe.com --json
  64. jobo search nurse --sort discovered_asc --discovered-after 2026-11-01 --discovered-before 2026-11-02 \
  65. --max 200 --csv -o nurses.csv
  66. ```
  67. Every filter of the API is a flag, generated from the same contract the other Jobo connectors use:
  68. | Flags | Values |
  69. | --- | --- |
  70. | `[query]` or `--q`, `--location`, `--search-description` | Free text. `--search-description false` matches titles only. |
  71. | `--work-model`, `--employment-type`, `--experience-level` | Fixed lists; see `jobo filters`. |
  72. | `--language` | ISO 639-1 codes: `en`, `de`. |
  73. | `--sources` | ATS ids such as `greenhouse`; `jobo filters sources`. |
  74. | `--companies`, `--exclude-companies` | A company id, a website domain or a whole company name; `jobo companies`. |
  75. | `--skills`, `--industries`, `--company-categories`, `--job-categories`, `--job-subcategories`, `--occupation-ids` (each with an `--exclude-` twin) | `jobo filters <facet>`. |
  76. | `--min-salary-usd`, `--max-salary-usd` | Numbers. |
  77. | `--posted-after`, `--posted-before`, `--discovered-after`, `--discovered-before` | ISO 8601, or an age: `24h`, `7d`, `2w`. |
  78. | `--sort` | `relevance` (default), `discovered_asc`, `discovered_desc`. |
  79. | `--description-format` | `markdown` (default), `html`, `enhanced`, `enhanced_html`. |
  80. List flags repeat or take commas (`--skills Python,Go`). Flags whose values are names (`--companies`,
  81. `--industries`, `--job-categories`, `--job-subcategories` and their `--exclude-` twins) are not split on
  82. commas, because the names can contain one: repeat the flag.
  83. Filter values are matched literally, so a wrong value returns zero results, not an error. The CLI
  84. rejects an unknown value of a fixed list before sending; for the others, look the value up first.
  85. Paging: `--page N`, `--page-size N` (1–100, default 10) and `--max N`. `--max` never bills more than N:
  86. search pages by number, so only whole pages are fetched and a remainder is left unfetched. The default
  87. order can shift between pages; for a stable walk use `--sort discovered_asc` with a
  88. `--discovered-after`/`--discovered-before` window. Search stops at a depth of 100,000 results: use the
  89. feed beyond that.
  90. `--include-fields none` returns the core fields only (no description, summary, qualifications,
  91. responsibilities or benefits) at the same price; `--facets work_model,sources` adds facet counts to the
  92. JSON output.
  93. ### `jobo job <id>`
  94. One full listing. Free.
  95. ```bash
  96. jobo job a1b2c3d4-e5f6-7890-abcd-ef1234567890
  97. ```
  98. ### `jobo feed`
  99. `POST /api/jobs/feed`, cursor-walked, written as JSONL (one job per line). Billed per new job, so it
  100. needs `--max N` or `--all`. Not available with a sandbox key.
  101. ```bash
  102. jobo feed --max 500 --sources greenhouse,lever --work-models remote > jobs.jsonl
  103. jobo feed --all --locations "country=United States" --job-subcategories Nursing \
  104. --company-is-agency false --cursor-file nursing.cursor --output nursing.jsonl --append
  105. ```
  106. - `--max N` is exact: the last batch is shrunk to fit. `--batch-size N` (1–1000) sets the request size.
  107. - After every batch the next cursor is printed on stderr, and with `--cursor-file FILE` saved to that
  108. file once the batch's jobs are written. If the run dies, run the same command again: it resumes from
  109. the file. The file is removed when the scan completes. `--cursor CURSOR` resumes from a cursor you
  110. kept yourself. Cursors do not expire.
  111. - A cursor keeps the filters and batch size of the scan it came from; filters given with one are ignored.
  112. - Filters are the feed's own (plural) fields: `--locations`, `--sources`, `--work-models`,
  113. `--employment-types`, `--experience-levels`, `--languages` and their `--exclude-` twins;
  114. `--companies`, `--job-categories`, `--job-subcategories`, `--occupation-ids`, `--industries`,
  115. `--company-primary-industries`, `--company-categories`, `--company-sizes`, `--company-revenues`, each
  116. with an `--exclude-` twin; `--company-is-agency`, `--posted-after`, `--include-reactivated`,
  117. `--updated-after`, `--description-format`. `--locations` takes `country=…[,region=…][,city=…]` or a
  118. bare country name. `--body JSON|@FILE` passes a raw request body, such as one written by the
  119. [Feed Builder](https://jobo.world/api/feed-builder).
  120. - Retries follow the API's rules: `429`, `500` and `503` are retried after `Retry-After`; `402` and a
  121. dead cursor (`400 invalid_cursor`, `409 feed_cursor_restart_required`) are not. A dead cursor exits 8:
  122. discard it and start a new scan.
  123. - Other formats: `--csv` streams too; `--json` and `--table` collect everything first.
  124. ### `jobo expired`
  125. Ids of jobs that left the employer's career site, to close them in your own store. Free. Not available
  126. with a sandbox key.
  127. ```bash
  128. jobo expired --since 24h --jsonl
  129. jobo expired --since 2026-11-18T00:00:00Z --all --csv -o expired.csv
  130. ```
  131. The window starts 24 hours ago by default and reaches back at most 7 days. `--limit N` (default 1,000)
  132. caps the ids returned; `--all` returns the whole window.
  133. ### `jobo company <id>` and `jobo companies <query>`
  134. ```bash
  135. jobo companies stripe # name or domain prefix → ids, domain, country, live job count
  136. jobo company b5e6f7a8-1234-5678-9abc-def012345678
  137. ```
  138. Both are free; `jobo company` works without an API key. One company can have several ids, one per
  139. careers board: pass every id from `ids` to `--companies`.
  140. ### `jobo geocode <location>`
  141. ```bash
  142. jobo geocode "San Francisco, CA"
  143. ```
  144. Coordinates and normalized city, region and country names. **$0.001 per lookup**, charged whether or not
  145. the place resolves; an unresolved place prints `succeeded: false` and exits 1. Not available with a
  146. sandbox key.
  147. ### `jobo filters` and `jobo occupations`
  148. ```bash
  149. jobo filters # fixed vocabularies, and every source with its live job count
  150. jobo filters skills pyth # values of one open vocabulary, optionally narrowed by a query
  151. jobo filters occupations nurse --json
  152. jobo occupations --csv -o occupations.csv
  153. ```
  154. Facets: `sources`, `industries`, `skills`, `company_categories`, `job_categories`, `job_subcategories`,
  155. `occupations`. `--limit N` (1–250, default 50). The `value` column is what the matching search flag
  156. takes; for occupations that is the occupation id. `jobo occupations` prints the whole taxonomy. All
  157. free; none are available with a sandbox key.
  158. ### `jobo usage`
  159. ```bash
  160. jobo usage
  161. ```
  162. Makes one free call and reports the key in use and its rate-limit position. The API has no balance
  163. endpoint: it reports the wallet balance and included jobs only on billed Search and Feed responses, which
  164. is the `usage:` line those commands print. The balance is also on the
  165. [billing page](https://enterprise.jobo.world/credits).
  166. ## Output
  167. | stdout | Default format |
  168. | --- | --- |
  169. | A terminal | A table (the feed: JSONL) |
  170. | A pipe or file | JSON (the feed: JSONL) |
  171. `--json`, `--jsonl`, `--csv` and `--table` choose a format. `--output FILE` (`-o`) writes a file and
  172. takes its format from the extension (`.json`, `.jsonl`, `.ndjson`, `.csv`) unless a flag says otherwise;
  173. an existing file is refused unless you pass `--overwrite` or, for JSONL and CSV, `--append`.
  174. `--fields id,title,company.name` keeps only those fields, as dot paths: the columns of a table or CSV,
  175. and the keys of each JSON record.
  176. Data goes to stdout. Usage lines, progress, cursors, warnings and errors go to stderr, so piping stays
  177. clean; `--quiet` silences everything on stderr but errors.
  178. ### Exit codes
  179. | Code | Meaning |
  180. | --- | --- |
  181. | 0 | Success |
  182. | 1 | The API refused the request, or another error |
  183. | 2 | Bad arguments. Nothing was sent |
  184. | 3 | No API key, a malformed one, or one the API rejected |
  185. | 4 | Insufficient credits (`402`) |
  186. | 5 | Rate limited (`429`) after retries |
  187. | 6 | Not found, or not available with a sandbox key |
  188. | 7 | The API could not be reached, or kept failing after retries |
  189. | 8 | The feed cursor cannot be continued: start a new scan |
  190. ## Agent Skill
  191. The package includes an [Agent Skill](skills/jobo-job-search/SKILL.md), `jobo-job-search`: instructions
  192. that tell a coding agent when to reach for this CLI, which flags exist, how to look up valid filter
  193. values, and the cost rules it has to respect.
  194. ```bash
  195. jobo skill install # → ~/.claude/skills/jobo-job-search
  196. jobo skill install --project # → ./.claude/skills/jobo-job-search
  197. jobo skill install --dir PATH # → PATH/jobo-job-search
  198. jobo skill path # where the bundled skill folder lives
  199. jobo skill show >> AGENTS.md # print SKILL.md, for agents that read one instructions file
  200. ```
  201. An existing copy is left alone unless you pass `--overwrite`.
  202. ## MCP server
  203. For an AI client, the hosted Jobo MCP server (`https://jobs-mcp.jobo.world/mcp`) gives the same search
  204. without a terminal. It signs you in with your Jobo account through OAuth, so there is no API key to
  205. paste, and its searches bill like `jobo search`.
  206. ```bash
  207. jobo mcp # the clients this CLI has instructions for
  208. jobo mcp claude-code # the command to run, or the config to paste, for one client
  209. jobo mcp cursor --json
  210. ```
  211. `jobo mcp` only prints instructions. It never writes to another tool's configuration. See the
  212. [MCP server docs](https://jobo.world/docs/connectors/mcp).
  213. ## Environment
  214. | Variable | Purpose |
  215. | --- | --- |
  216. | `JOBO_API_KEY` | API key. Beats the saved key; `--api-key` beats both. |
  217. | `JOBO_API_URL` | API base URL, default `https://connect.jobo.world`. For proxies and tests; plain `http` is accepted for localhost only. |
  218. | `XDG_CONFIG_HOME` | Moves the config file to `$XDG_CONFIG_HOME/jobo/config.json`. |
  219. ## Development
  220. This package lives in the Jobo monorepo under `Jobo.Connectors/cli/` and is standalone: it has its own
  221. lockfile and is not an npm workspace member.
  222. ```bash
  223. npm ci
  224. npm run typecheck
  225. npm run build
  226. npm test
  227. ```
  228. `@jobo-ai/connector-core`, the client shared by every Jobo connector, is a devDependency pinned to an
  229. exact version and inlined into `dist/` at build time, so the published package has no runtime
  230. dependencies. The search flags are generated from that package's filter contract, and a test fails when
  231. the contract gains a filter the CLI has no proof for. Tests run against a fake transport: no network and
  232. no API key.
  233. ## License
  234. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.