@dephealth/cli

Check npm package health scores from the command line.

Installation

npm install -g @dephealth/cli
# or
npx @dephealth/cli check lodash

Requires Node.js 20+.

Setup

Get your API key at dephealth.laranjo.dev.

# Option 1: Interactive setup
dephealth config set

# Option 2: Environment variable (for CI)
export DEPHEALTH_API_KEY=dh_your_key_here

Commands

Check a package

dephealth check lodash
dephealth check @babel/core
dephealth check lodash --json    # JSON output

Scan package.json

dephealth scan                      # Scan ./package.json
dephealth scan ./path/to/project
dephealth scan --fail-on HIGH       # Exit 1 if HIGH or CRITICAL (CI mode)
dephealth scan --fail-on CRITICAL   # Exit 1 only on CRITICAL
dephealth scan --json               # JSON output

Check API usage

dephealth usage

Configuration

dephealth config set    # Set API key
dephealth config show   # Show configuration
dephealth config clear  # Clear configuration

CI/CD Integration

# GitHub Actions example
- name: Check dependencies
  env:
    DEPHEALTH_API_KEY: ${{ secrets.DEPHEALTH_API_KEY }}
  run: npx @dephealth/cli scan --fail-on HIGH

Exit Codes

| Code | Meaning | |------|---------| | 0 | Success | | 1 | Risk threshold exceeded (with --fail-on) | | 2 | CLI error (network, auth, invalid args) |

License

MIT