bolna-cli environment, with an animated checklist on a real terminal.
Syntax
bolna doctor [flags]
What it checks
| Check | What it verifies |
|---|---|
| Config directory | Whether the config directory exists and is writable |
| OS keychain | Whether the platform credential store is reachable |
| API key configured | Whether a key is set, and where it came from |
| Bolna API reachable | Whether api.bolna.ai responds |
| API key valid | Whether the configured key authenticates, and as whom |
| TUI support | Whether the current terminal supports the dashboard |
Flags
| Flag | Description | Default |
|---|---|---|
-h, --help | Show help for the command | – |
-o, --output string | Output format: table (animated) or json for CI | table |
Example
bolna doctor
✓ Config directory writable ~/.config/bolna
✓ OS keychain reachable macOS Keychain
✓ API key configured from keychain (profile: default)
✓ Bolna API reachable api.bolna.ai (142ms)
✓ API key valid authenticated as ops@acme.com
✓ Terminal supports interactive UI xterm-256color
All checks passed.
In CI
bolna doctor --json | jq -e '.checks[] | select(.status != "ok")' && exit 1