Staplehire CLI

The official CLI for Staplehire. Run your hiring pipeline from the terminal and from AI coding agents (Cursor, Claude Code, Codex).

npm install -g @staplehire/staplehire-cli

Binary: staplehire · Package: @staplehire/staplehire-cli

Quickstart

# 1. Authenticate (opens browser, writes STAPLEHIRE_KEY to .env)
staplehire init

# 2. Verify
staplehire me

# 3. Create a role from a job description
staplehire roles create --jd "Senior backend engineer. TypeScript, remote."

# 4. Install the agent skill (Cursor / Claude / Codex)
staplehire skills install

Agent skill

Coding agents should load the staplehire-cli skill before running commands:

staplehire skills install

See skills/staplehire-cli/SKILL.md for the JSON contract, exit codes, and command reference.

Environment

| Variable | Description | |----------|-------------| | STAPLEHIRE_KEY | API key (sh_live_…) — from staplehire init or Settings → Developers | | STAPLEHIRE_API_URL | API gateway (default https://api.staplehire.com; written by init) |

Copy .env.example to .env if you set the key manually.

Commands

staplehire init | me | skills install
staplehire roles create --jd <text|file|->
staplehire stages create|list|candidates …
staplehire candidates add|move|enrich|research|send-interview|interview-link …
staplehire interview-design create …
staplehire interview-sessions <roleId>
staplehire sourcing start|prospects …
staplehire jobs get|list|poll …

Run staplehire --help for the full list. All data commands print JSON to stdout.

Example script

chmod +x examples/hiring-loop.sh
export STAPLEHIRE_KEY=sh_live_…
./examples/hiring-loop.sh

Development

git clone https://github.com/staplehire/staplehire-cli.git
cd staplehire-cli
npm install
npm run build
node bin/staplehire.mjs me

Regenerate the HTTP client after API changes:

npm run generate && npm run build

OpenAPI spec: openapi/staplehire-api.yaml.

Publishing

Maintainers: see PUBLISHING.md.

License

MIT — see LICENSE.