bolna doctor

Run a full health check of your 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

Bolna MCP

Bolna Skills

SDKs

Bolna CLI

AI-readable docs

Syntax

What it checks

Flags

Example

In CI

Next steps

docs search

CLI overview

​Syntax

​What it checks

​Flags

​Example

​In CI

​Next steps

docs search

CLI overview

Syntax

What it checks

Flags

Example

In CI

Next steps