Command-line interface
The nebbos command-line client provides scriptable access to every substrate operation available through the REST and MCP surfaces.
Installation
macOS · Homebrew
brew install nebbos-ai/tap/nebbosCommand 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