CLI

Install the bks CLI.

npm install -g @blankstate/cli

Authentication

bks auth login

This authenticates with an API token from the Atlas API Dashboard and stores it in ~/.blankstate/config.json. For CI:

export BLANKSTATE_API_TOKEN=bks_your_token

bks auth status      # show current auth state
bks auth logout      # remove the saved token

Status

bks status           # API status, SGM versions, ICS balance

Sense

Content is positional — bks sense <protocol> <content>:

bks sense proto-xxx:1.0 "I understand this has been difficult..."

Read content from a file instead:

bks sense proto-xxx:1.0 --file transcript.txt

Session — live, multi-protocol

bks session proto-xxx:1.0                    # interactive, inline
bks session proto-aaa:1.0 proto-bbb:2.0 --tui   # full-screen dashboard
tail -f agent.log | bks session proto-xxx:1.0 --pipe   # watch a stream

Protocols

bks protocol list                # list your protocols
bks protocol inspect <id>        # show a protocol definition (--save to write .yaml)

Options (`bks sense`)

Flag	Description
`--file <path>`	Read content from a file instead of the positional argument
`--language <code>`	Language code (default: `en`)
`--profile <type>`	`raw` (default) · `detailed` · `discovery`
`--depth <measure\|full>`	Core scores or full decomposition
`--detail`	Show resonance, actants, and evidence
`--save [md\|yaml\|both]`	Save the measurement artifact
`--trace`	Save the measurement trace (`.md`)

Environment

Var	Description
`BLANKSTATE_API_TOKEN`	API token (overrides saved config)
`BLANKSTATE_API_URL`	API URL (default: `https://ibf.blankstate.ai`)

Overview

Packages

Authentication

Status

Sense

Session — live, multi-protocol

Protocols

Options (`bks sense`)

Environment

​Authentication

​Status

​Sense

​Session — live, multi-protocol

​Protocols

​Options (bks sense)

​Environment

Authentication

Status

Sense

Session — live, multi-protocol

Protocols

Options (`bks sense`)

Environment