Troubleshoot VB-OS CLI Errors
Authentication Errors
Section titled “Authentication Errors”vbos: error: not authenticated
Section titled “vbos: error: not authenticated”The CLI is not logged in or the session has expired.
Fix:
vbos loginvbos: error: api key not set
Section titled “vbos: error: api key not set”No API key configured for non-interactive use.
Fix:
export VBOS_API_KEY=vbos_your_key_hereCommon Exit Codes
Section titled “Common Exit Codes”| Code | Meaning |
|---|---|
0 |
Success |
1 |
General error / DEFER verdict |
2 |
Authentication or API error |
130 |
Interrupted (Ctrl+C) |
Compilation Errors
Section titled “Compilation Errors”vbos: error: compilation failed
Section titled “vbos: error: compilation failed”The VBL source has syntax or semantic errors.
Fix:
- Check the error message for the specific line and column
- Verify VBL syntax against the Language Reference
- Common issues: missing colon after
predicate, wrong operator, undefined set reference
Next Steps
Section titled “Next Steps”- CLI Installation: install and configure
- CLI Commands: command reference
- Exit Codes: complete exit code reference