CLI Reference

The Sentinel CLI — built on oclif. Everything the API does, from your terminal.

Installation

Homebrew

brew install kajeet/tap/sentinel

npm

npm install -g @kajeet/sentinel-cli

Requires Node.js 18+. After installation, run sentinel auth login to get started.

Authentication

sentinel auth login

Authenticate with Sentinel via browser OAuth2 flow

Example

$ sentinel auth login
✓ Opened browser for authentication
✓ Logged in as admin@northstar-isd.edu
✓ Token saved to ~/.sentinel/credentials

sentinel auth login --sso

Authenticate via SAML SSO for enterprise accounts

Example

$ sentinel auth login --sso
✓ Redirecting to SSO provider...
✓ Authenticated via Northstar ISD SSO
✓ Token saved

sentinel auth whoami

Show current authentication status and account info

Example

$ sentinel auth whoami
✓ Authenticated as admin@northstar-isd.edu
Corp: NORTHSTAR-ISD (Northstar Independent School District)
Role: org_super
Token expires: 2026-03-13 08:00 ET

sentinel auth token

Display or generate API token for CI/CD and scripts

Flags: --generate | --ttl <duration>

sentinel auth switch <account>

Switch to a different Sentinel account/corp

Example

$ sentinel auth switch PIONEER-ISD
✓ Switched to PIONEER-ISD (Pioneer Independent School District)

Global Flags

--jsonOutput as JSON (available on every command)

--csvOutput as CSV

--corp <id>Override default corp ID

--no-colorDisable colored output

--verboseShow HTTP request/response details

--quietSuppress non-essential output