Troubleshooting All Tiers

# Check if installed
pip show bpsai-pair

# If installed, find the location
python -m site --user-base
# Add the bin directory to your PATH

# Or run directly
python -m bpsai_pair.cli --help

# Check your Python version
python --version

# If too old, install a newer version
# macOS:
brew install python@3.12

# Ubuntu:
sudo apt install python3.12

# Then reinstall
pip3.12 install bpsai-pair

# DON'T use sudo pip install
# Instead, use --user flag or pipx

# Option 1: User install
pip install --user bpsai-pair

# Option 2: pipx (recommended)
pip install pipx
pipx install bpsai-pair

# Check license location
ls -la ~/.paircoder/license.json

# Install or reinstall license
bpsai-pair license install ~/Downloads/license.json

# Verify license
bpsai-pair license status

# Verify your license
bpsai-pair license verify

# If invalid, re-download from your email
# Then reinstall
bpsai-pair license install ~/Downloads/new-license.json

# Initialize the project
bpsai-pair init

# Or run wizard for guided setup
bpsai-pair wizard

# Validate config
bpsai-pair config validate

# Regenerate default config
bpsai-pair config reset

# Or manually fix .paircoder/config.yaml
# Check for YAML syntax errors

# Check environment variables are set
echo $TRELLO_API_KEY
echo $TRELLO_TOKEN

# If empty, set them:
export TRELLO_API_KEY="your-api-key"
export TRELLO_TOKEN="your-token"

# Test connection
bpsai-pair trello boards

# List available boards
bpsai-pair trello boards

# Set board in config
bpsai-pair config set trello.board_id "YOUR_BOARD_ID"

# Or set via environment
export TRELLO_BOARD_ID="YOUR_BOARD_ID"

# PairCoder auto-detects WSL and provides hints
# If paths aren't resolving:

# Check WSL detection
bpsai-pair system info

# Convert paths manually if needed
wslpath -u "C:\Users\name\project"
# Output: /mnt/c/Users/name/project

# For VS Code, use the WSL extension
code .  # Should open in WSL mode

# Set editor explicitly
export PAIRCODER_EDITOR="code"

# Or for Windows apps from WSL
export PAIRCODER_EDITOR="/mnt/c/Users/name/AppData/Local/Programs/cursor/Cursor.exe"

# Set UTF-8 encoding in WSL
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8

# Add to ~/.bashrc for persistence

# Set your API key
export ANTHROPIC_API_KEY="sk-ant-..."

# Add to shell config for persistence
echo 'export ANTHROPIC_API_KEY="sk-ant-..."' >> ~/.bashrc
source ~/.bashrc

# Regenerate CLAUDE.md
bpsai-pair claude-md generate

# Check it exists in project root
ls -la CLAUDE.md

# Ensure you're running Claude Code from project root
cd /path/to/project
claude-code .

# Enable debug logging to see what's slow
export PAIRCODER_DEBUG=1
bpsai-pair status

# Check for large files in .paircoder/
du -sh .paircoder/*

# Clear cache if needed
bpsai-pair cache clear

# Get system info for bug reports
bpsai-pair system info

# Output:
# PairCoder: 2.20.0
# Python: 3.12.0
# Platform: Linux (WSL2)
# License: Solo (valid)
# Config: /home/user/project/.paircoder/config.yaml

bpsai-pair support