VB-OS CLI Exit Codes

The vbos CLI returns standard exit codes for programmatic use.

Code	Meaning
0	Success
1	General error (invalid input, operation failed, DEFER verdict)
2	Authentication or API error (missing/expired credentials, HTTP errors)
130	Interrupted (SIGINT)

Usage in Scripts

vbos verify --workload payload.json --project my-project
status=$?

case $status in
  0) echo "Evaluation succeeded (ASSERT)" ;;
  1) echo "Evaluation failed (DEFER) or general error" ;;
  2) echo "Re-authenticate: vbos login" ;;
  130) echo "Interrupted" ;;
  *) echo "Unexpected exit code $status" ;;
esac

CI/CD Integration

Exit codes allow direct use in CI pipelines. A non-zero exit stops the pipeline:

vbos verify --workload payload.json \
  --project my-project \
  --format json \
  --quiet

The --quiet flag suppresses output except IDs, useful when only the exit code matters.