Skip to Content
IntegrationCLI tools

Command-line interface

The nebbos command-line client provides scriptable access to every substrate operation available through the REST and MCP surfaces.

Installation

brew install nebbos-ai/tap/nebbos

Command surface

Every command carries the same three-tier authorisation gate as the REST and MCP surfaces. Guest-tier identities may execute read commands. Write commands invoke the device-native biometric ceremony and, at Host tier and above, require the Cradle.

Command families correspond to the REST endpoint categories:

nebbos identity ... # session lifecycle, tier stepping nebbos pearl ... # per-department reasoning nebbos task ... # operational tracker nebbos signal ... # cross-domain risk nebbos audit ... # hash-chained audit log nebbos admin ... # substrate mutation (Architect tier only)

Each family self-describes via nebbos <family> --help.

Scripting patterns

Every command supports the --json flag and emits shell-parseable output. The pattern below walks the last five minutes of audit-chain activity for the calling operator:

nebbos audit list --since 5m --json \ | jq -r '.events[] | "\(.tool)\t\(.tier)\t\(.outcome)"'

Non-interactive continuous-integration usage: the Bearer token is provided through the NEBBOS_TOKEN environment variable. Read operations execute headlessly. Higher-tier write operations are refused in continuous-integration contexts unless the operator identity is provisioned as a service account with the corresponding tier. Ordinary user identities do not elevate in the absence of the biometric and Cradle ceremony executed on the operator’s physical device.

Reference commands

# Report current tier and department scope nebbos identity whoami # Enumerate the last hour of audit events, tab-separated nebbos audit list --since 1h --json \ | jq -r '.events[] | [.ts, .operator, .tool, .outcome] | @tsv' # Verify an audit-chain segment for the calling operator nebbos audit verify --from evt_01H8Y... --to evt_01H8Z... # Produce an operator-scoped portability bundle nebbos export --output ./my-nebbos-export.tar.gz