CLI

Install the bks CLI.

npm install -g @blankstate/cli

Authentication

bks auth login

This opens the Atlas login flow and stores a token locally. For CI environments:

export BKS_KEY=your_api_key

bks sense \
  --protocol empathy \
  --actant user_001 \
  --content "I understand this has been difficult..."

Pass a file instead of inline content:

bks sense --protocol empathy --file transcript.txt

bks sense --blueprint advisory-quality --file call.txt

bks protocols list

bks signatures get user_001

bks usage

Flag	Description
`--protocol`	Protocol id or comma-separated list
`--blueprint`	Blueprint id
`--actant`	Actant id for Signature tracking
`--modality`	`text` (default), `transcript`, `audio`, `video`
`--fidelity`	Override fidelity threshold (0–1)
`--json`	Output raw JSON
`--quiet`	Suppress headers and labels