HiBob CLI

Command-line interface for querying the HiBob employee directory and who's out.

Installation

npm install -g @doist/bob-cli

Agent Skills

Install skills for your coding agent:

bob skill install claude-code
bob skill install codex
bob skill install cursor
bob skill install gemini
bob skill install pi
bob skill install universal

Skills are installed to ~/<agent-dir>/skills/bob-cli/SKILL.md (e.g. ~/.claude/ for claude-code, ~/.agents/ for universal, etc.). When updating the CLI, installed skills are updated automatically. The universal agent is compatible with Amp, OpenCode, and other agents that read from ~/.agents/.

bob skill list
bob skill uninstall <agent>

Uninstallation

First, remove any installed agent skills:

bob skill uninstall <agent>

Then uninstall the CLI:

npm uninstall -g @doist/bob-cli

Local Setup

git clone https://github.com/Doist/bob-cli.git
cd bob-cli
npm install
npm run build
npm link

Setup

Set credentials as environment variables:

export HIBOB_SERVICE_ID="your-service-user-id"
export HIBOB_API_TOKEN="your-api-token"

Usage

bob people
bob people "john"
bob people --department "Engineering"
bob person <id>

bob whosout
bob whosout --from 2024-01-15 --to 2024-01-20

bob outtoday
bob outtoday --date 2024-01-15

Output formats

All list commands support:

• --json - JSON output (essential fields)
• --ndjson - NDJSON output (one JSON object per line)
• --full - Include all fields in JSON output

CI & Releases

• CI runs npm ci, npm run build, and npm test on pushes and PRs to main.
• Releases are automated with Release Please, which creates release PRs and tags, then triggers the publish workflow.