Setup Wizard All Tiers

Interactive configuration guide for PairCoder projects.

Overview

The setup wizard provides an interactive way to configure PairCoder for your project. It guides you through essential settings and optionally configures integrations like Trello, GitHub, and MCP tools.

Launch the Wizard

bash 
bpsai-pair wizard

Setup Modes

Quick Setup

For users who want to get started immediately with sensible defaults. The wizard will configure essential settings and skip optional integrations.

Quick Setup Includes
  • Project initialization
  • License verification
  • Basic configuration
  • CLAUDE.md generation

Guided Setup

For users who want full control over configuration. The wizard will walk through each option and explain what it does.

Guided Setup Includes
  • Everything in Quick Setup
  • Trello board connection
  • GitHub repository setup
  • MCP server configuration
  • Editor preferences
  • Architecture limits customization

API Key Requirement

Before running the wizard, ensure you have your Anthropic API key set in your environment. This is required for Claude Code to work.

bash 
# Set your API key (add to ~/.bashrc or ~/.zshrc for persistence)
export ANTHROPIC_API_KEY="sk-ant-..."
Important

The wizard will check for your API key and warn you if it's not set. You can skip this check, but Claude Code won't function without it.

MCP Configuration

The wizard can automatically configure PairCoder's MCP (Model Context Protocol) server for use with Claude Desktop.

bash 
# The wizard will offer to add this to claude_desktop_config.json
{
  "mcpServers": {
"paircoder": {
  "command": "bpsai-pair",
  "args": ["mcp", "serve"]
}
  }
}

What Gets Created

After running the wizard, your project will have:

File/Folder Purpose
.paircoder/ Project configuration directory
.paircoder/config.yaml Main configuration file
.paircoder/context/ Context files (project.md, state.md)
.paircoder/tasks/ Task definition files
.paircoder/plans/ Plan definition files
CLAUDE.md Instructions for Claude Code

Running Without Wizard

If you prefer manual setup, you can initialize a project directly:

bash 
# Initialize without wizard
bpsai-pair init

# Or with specific options
bpsai-pair init --name "my-project" --type feature

Re-running the Wizard

You can re-run the wizard at any time to update settings:

bash 
# Re-run wizard (won't overwrite existing config)
bpsai-pair wizard

# Force reconfiguration
bpsai-pair wizard --force

Next Steps