Licensing - PairCoder Docs

License Tiers

PairCoder is available in three tiers to match your needs:

Feature	Solo	Pro	Enterprise
Core Workflow
Skills, State, Planning, Slash commands	✓	✓	✓
Enforcement
Strict mode, AC gates, Containment, Audit logging	✓	✓	✓
Metrics
Basic metrics (local)	✓	✓	✓
Token budgeting, Cost tracking, Model routing	—	✓	✓
Integrations
Trello, GitHub, MCP server, Timer/Toggl	—	✓	✓
Scale & Team
Multi-workspace, Remote access, SSO, Team mgmt	—	—	✓

Installing Your License

From File

After purchasing, download your license file and install it:

bash

bpsai-pair license install ~/Downloads/license.json

Using Setup Wizard

The interactive wizard can guide you through license installation:

bash

bpsai-pair wizard

Check License Status

bash

bpsai-pair license status

Example output:

bash

License Status
==============
Tier: Pro
Status: Active
Email: you@example.com
Expires: 2027-01-22
Features: trello, github, mcp, budgeting, routing

Managing Your Subscription

Manage your subscription directly through the Stripe Billing Portal:

bash

# Open the billing portal in your browser
bpsai-pair subscription manage

# Just print the portal URL (don't open browser)
bpsai-pair subscription manage --no-browser

# Check your current subscription status
bpsai-pair subscription status

In the Stripe Billing Portal you can:

Upgrade or downgrade your tier (changes are prorated)
Update payment method (card, billing address)
Cancel subscription (remains active until end of billing cycle)
View invoices and download receipts

Billing Cycle

Upgrades are prorated immediately. Downgrades and cancellations take effect at the end of your current billing cycle—you retain access to your current tier until then.

License Location

Your license is stored globally at:

bash

~/.paircoder/license.json

This applies to all projects on your machine.

Machine Binding

PairCoder v2.11+ binds licenses to specific machines to prevent unauthorized sharing.

Machine Limits by Tier

Tier	Max Machines
Solo	1
Pro	2
Enterprise	5

Machine Commands

bash

# View your machine ID
bpsai-pair license machine-id

# Activate current machine
bpsai-pair license activate

# Free up a machine slot
bpsai-pair license deactivate

# List all activated machines
bpsai-pair license machines

Online Validation

Pro and Enterprise licenses validate online at startup to ensure license integrity.

Offline Mode

For air-gapped or restricted network environments:

bash

# Set environment variable for offline mode
export PAIRCODER_OFFLINE=1

# Or use --offline flag on any command
bpsai-pair status --offline

Grace Period

Cached validations are valid for 7 days. After this period, online validation is required to continue using licensed features.

Troubleshooting Validation

bash

# Clear validation cache
bpsai-pair license clear-cache

# Verify CLI/API key alignment
bpsai-pair license verify-keypair

Important

Do not share your license file. Each license is tied to a specific user and machine fingerprint.

FAQ

What's the difference between tiers?

Solo ($29/mo) — AI pair programming with guardrails. Skills, planning, enforcement gates. Everything local.
Pro ($79/mo) — Connect to your workflow. Adds Trello, GitHub, MCP, token budgeting, model routing.
Enterprise (Contact Sales) — Code from anywhere, with your team. Adds remote access, multi-workspace, SSO, team management.

Can I upgrade or downgrade my subscription?

Yes. Run bpsai-pair subscription manage to open the Stripe Billing Portal where you can upgrade, downgrade, or cancel your subscription. Upgrades are prorated immediately; downgrades take effect at the end of your billing cycle.

What happens when my license expires?

PairCoder will revert to Solo tier where only core commands work. All your data and configuration remain intact. Renew your license to restore full functionality.

Can I use PairCoder on multiple machines?

Yes, with machine limits by tier: Solo (1 machine), Pro (2 machines), Enterprise (5 machines). Use bpsai-pair license machines to see your activated machines and bpsai-pair license deactivate to free up a slot.

Pricing

See our Pricing page for current pricing and promotional offers.