JDWatch CLI is a standalone command-line tool for customized job scraping, config validation, and My Jobs management.
It is independent from—but interoperates with—Open API and Skills: the CLI calls the server with your Open API key (sk_live_*); Agents can orchestrate the same CLI via Skills.
Auth: create an sk_live_* key under Settings → API Key (Open API). Admin Cron Tokens are for internal automation only and cannot log into the CLI.
| Category | Command | Ability |
|---|---|---|
| Auth | @jdwatch/cli auth | Configure login authentication; supports a custom server URL |
| Pull | @jdwatch/cli pull | Pull and merge the latest company and job scraping source configurations from the remote server |
| Scrape | @jdwatch/cli scrape | Core scraping engine; filter by company/keyword; supports dry-run |
| Validate | @jdwatch/cli validate | Validate local sources.yml; supports --json with Agent-friendly hints |
| Propose | @jdwatch/cli propose | Submit company listing requests; admins can --review / --apply to complete config |
| Interactive | @jdwatch/cli interactive | Interactive wizard to select companies and recruitment types; ideal for local debugging |
| Job search | @jdwatch/cli jobs search @jdwatch/cli jobs get | jobs search for listings; jobs get for detail / official apply URL (job.url); returns integer job ids for saved add (separate from local scrape) |
| Companies | @jdwatch/cli companies list | companies list returns cloud companies with numeric ids for alerts --company-ids |
| Saved | @jdwatch/cli saved | Manage saved jobs: list / add / remove, synced with Web My Jobs → Saved |
| Alerts | @jdwatch/cli alerts | Manage job alerts (including alerts get); use companies list first for company-scoped alerts; synced with Web My Jobs → Alerts |
Want your assistant to drive the CLI in natural language? See the Skills page: /skills
npm / npx)