Troubleshooting

Solutions to common issues when using AI Code Reviews in CLI.

Enable debug output

bitoreview review --debug
# or
bitoreview review -d

Enable verbose logging

bitoreview review --verbose
# or
bitoreview review -v

Common issues

Issue: "API key not found"

# Set your API key
bitoreview config set-api-key YOUR_KEY

# Verify it's set
bitoreview config show-api-key

Issue: "Wingman binary not found"

Re-run the CLI installer to reinstall wingman:

• macOS/Linux (Terminal):

curl -fsSL https://bitoreview.bito.ai/install.sh | bash

• Windows (PowerShell):

irm https://bitoreview.bito.ai/install.ps1 | iex

Issue: Slow reviews on large codebases

• Use --mode essential for faster feedback

• Focus on specific files: bitoreview review src/changed-file.js

• Use --type uncommitted to limit scope

Issue: Too many low-priority issues

# Filter to high severity only
bitoreview review --severity high

# Or use essential mode
bitoreview review --mode essential

Performance expectations

Codebase size	Approximate time
Small (<5 files)	30-60 seconds
Medium (5-20 files)	1-3 minutes
Large (20+ files)	3-8 minutes