bpsai-pair 2.21.2

AI-augmented pair programming framework with 200+ CLI commands for planning, orchestration, Trello/GitHub integration, and autonomous workflows

bpsai-pair

AI-augmented pair programming framework with 200+ CLI commands

Overview

bpsai-pair (PairCoder) is a comprehensive AI pair programming framework that provides structured workflows, enforcement gates, and integrations to ensure AI agents follow proper development practices.

• Planning & Task Management — Sprint planning, task lifecycle, Trello sync, and budget tracking
• Skill-Based Workflows — 9 built-in skills for TDD, code review, releases, architecture, and more
• Integration Hub — Trello, GitHub, MCP servers, and Toggl time tracking
• Architecture Enforcement — File size limits, function boundaries, import caps, and auto-split suggestions
• Telemetry & Feedback — Session telemetry, self-calibrating estimation, anomaly detection
• Workspace Orchestration — Multi-project workspaces, cross-repo contract detection, impact analysis
• Intelligence Pipeline — Usage snapshots, value extraction scoring, tamper detection
• Interactive Setup Wizard — Web-based project configuration with AI-guided setup
• Licensing & Security — Tiered feature gating, secret scanning, containment mode
• Quality Control — Browser-based QC with spec format, execution runtime, and gate enforcement
• Containment Mode — Tiered file access control via PreToolUse hooks
• Autonomous Sprint Execution — bpsai-pair engage runs full sprints: branch, tasks, PR, review, observations
• Machine Interface — --json envelope on all commands for programmatic consumption
• Health Check — bpsai-pair doctor validates setup with 9 checks and auto-repair
• Slash Commands — /make-it-so (intent to PR), /draft-backlog (engage-compatible backlogs)

Installation

# Core installation
pip install bpsai-pair

# With integrations
pip install bpsai-pair[trello]      # Trello board sync
pip install bpsai-pair[github]      # GitHub PR management
pip install bpsai-pair[mcp]         # MCP server support
pip install bpsai-pair[all]         # All extras

Quick Start

# Initialize a new project
bpsai-pair init

# Or use the interactive wizard
bpsai-pair wizard

# Check project status
bpsai-pair status

# Create a sprint plan
bpsai-pair plan new my-feature --type feature

# Start a task (with Trello sync)
bpsai-pair ttask start TRELLO-123

# Run architecture checks
bpsai-pair arch check

# Pack context for AI assistants
bpsai-pair pack

Key Command Groups

Group	Commands	Description
plan	8	Sprint planning, task creation, Trello sync
task	12	Task lifecycle, status updates, archival
trello / ttask	27	Trello board management, card workflows
github	8	PR creation, merge, auto-archive
skill	8	Workflow skills, export to Cursor/Windsurf
license	10	License management, feature gating
telemetry	3	Session telemetry, privacy config, export
feedback	4	Calibration, accuracy, task-type estimates
workspace	5	Multi-project orchestration, impact analysis
arch	2	Architecture enforcement, split suggestions
budget	3	Token budget tracking, task cost estimates
security	4	Secret scanning, containment mode
qc	6	Quality check specs, execution, reporting
query	3	Cross-agent state and telemetry queries
engage	1	Autonomous sprint execution from backlog
containment	2	File access enforcement and status

License Tiers

Feature	Solo	Pro	Enterprise
Planning & tasks	Y	Y	Y
Skills & enforcement	Y	Y	Y
Setup wizard	Y	Y	Y
Telemetry & feedback	Y	Y	Y
Trello integration		Y	Y
GitHub integration		Y	Y
MCP servers		Y	Y
Token budget & cost tracking		Y	Y
Workspace orchestration		Y	Y
Remote access & SSO			Y

Check your license: bpsai-pair license status

What's New in v2.21

v2.21.1 -- Remote Session Enforcement

• SessionStart hook auto-installs PairCoder in remote ultraplan sessions
• API error surfacing across all license, support, and subscription commands
• --verbose flag on support open for debugging

v2.21.0 -- Enforcement + Observability

• Intent recognition: heuristic classifier prevents autonomous dispatch without explicit approval
• Approval gate: deterministic keyword matching blocks dispatch unless you say "make it so", "dispatch", or "engage"
• Operational signals: detect uncommitted driver code, abandoned sessions, repeated gate blocks
• Frustration detector: observation-only telemetry for workflow improvement
• Cache health monitoring: detect session resume cache degradation
• Protected branch guard: engage refuses to run on main/dev
• 12,333 tests passing, 21 security findings addressed

v2.20.0 -- Engage Pipeline

• bpsai-pair engage runs full sprints autonomously (branch, tasks, PR, review)
• /make-it-so command: intent to shipped PR in one command
• bpsai-pair doctor with 9 health checks and --fix auto-repair
• --json output on all major commands
• Model routing by task complexity

Documentation

• Website & Docs
• Quick Start Guide

Requirements

• Python 3.10 or higher
• Git (for project management features)

Support

• Email: [e-mail]