pr-vibe 🎵

🎵 When AI tools vibe together on your PRs. Let CodeRabbit, Claude Code, and other bots handle the repetitive feedback while you ship features.

Built BY an AI (Claude) FOR AIs to orchestrate - the first tool designed for AI-to-AI collaboration on code reviews.

Demo

1# Try instantly without any setup!
2npx pr-vibe@latest demo

Visit our interactive demo to see pr-vibe in action.

Why pr-vibe?

PR review bots like CodeRabbit, Claude Code, and DeepSource are great, but they don't understand your project. You find yourself:

• Explaining why console.log is valid in Lambda functions... again
• Rejecting the same "any types" warnings for complex webhooks
• Manually fixing the same security issues they flag
• Waiting for bot responses and handling rate limits

pr-vibe bridges this gap by:

• 🤝 Working WITH bots - Enhances CodeRabbit, Claude Code, DeepSource, etc. rather than replacing them
• 💬 Full Conversations - Handles multi-round dialogues until resolution
• 🧠 Learning your patterns - Remembers your project's conventions and valid exceptions
• ⚡ Automating responses - Fixes what should be fixed, explains what's intentional
• 🎯 Saving time - Handle bot comments in seconds, not minutes
• 🤖 Claude Code Support - Special integration for Claude Code's confidence levels and categorization

Features

• 🚀 Zero-Setup Demo - Try instantly with npx pr-vibe@latest demo
• 💬 Full Conversation Support - Handles multi-round dialogues with bots, including rate limits
• 🔐 Smart Auth Detection - Finds GitHub tokens from gh CLI, env vars, VS Code automatically
• 🔍 Bot Comment Analysis - Parses and understands comments from all major PR review bots
• 🛠️ Smart Actions - Auto-fix simple issues, explain valid patterns, or escalate edge cases
• 🧠 Project Memory - Learns and remembers your project-specific patterns
• ⏱️ Rate Limit Handling - Detects and waits for bot rate limits automatically
• 📊 Detailed Reports - Save comprehensive reports of all actions taken for review
• ✅ Pre-Merge Safety - Check if all bot comments are resolved before merging
• 📈 GitHub Status Checks - Post status checks to PRs for team visibility
• 🗑️ Auto-Cleanup - Reports expire after 30 days to keep your repo clean
• 🔌 LLM Flexibility - Works with Claude, GPT-4, Gemini, or without any LLM
• ⚡ CLI First - Full control with human-in-the-loop design

Installation

1npm install -g pr-vibe
2
3# Or use directly with npx
4npx pr-vibe review 42

Getting Started

Option 1: Try the Demo (No Setup Required!)

1npx pr-vibe@latest demo

Option 2: Quick Start (60 seconds)

1. Install pr-vibe globally:

   1npm install -g pr-vibe

2. Check authentication status:

   1pr-vibe auth

   pr-vibe will automatically detect GitHub tokens from:

   • GitHub CLI (gh auth token)

   • Environment variables (GITHUB_TOKEN, GH_TOKEN)

   • VS Code GitHub extension

   • Git config

   🔐 Security Note: Never commit tokens to the repository. See SECURITY.md for best practices.

3. Initialize in your project:

   1cd your-project
   2pr-vibe init

4. Review your next PR with bot comments:

   1pr-vibe pr 42

That's it! pr-vibe will analyze bot comments, handle conversations, and start learning your patterns.

Commands

1# Interactive demo - no setup required!
2pr-vibe demo
3
4# Check authentication status
5pr-vibe auth
6
7# Initialize patterns in your project
8pr-vibe init
9
10# Review bot comments interactively
11pr-vibe pr 42
12
13# Filter comments by priority
14pr-vibe pr 42 --skip-nits  # Focus on critical issues only
15pr-vibe pr 42 --nits-only  # Review only style/formatting comments
16pr-vibe pr 42 --show-all   # Show all comments including non-critical
17
18# Priority-based filtering (NEW in v0.12.0)
19pr-vibe pr 42 --critical-only           # Only must-fix issues (security, bugs)
20pr-vibe pr 42 --priority-threshold suggestion  # Show must-fix + suggestions
21pr-vibe pr 42 --priority-threshold nitpick     # Show all (default)
22# Note: --critical-only is equivalent to --priority-threshold must-fix
23
24# Smart watch mode - wait for bots to arrive
25pr-vibe watch 42                # Watch for bot reviews with smart polling
26pr-vibe watch 42 --auto-process # Auto-process when all bots complete
27pr-vibe watch 42 --timeout 30   # Custom timeout (default 10 minutes)
28
29# Create GitHub issues for deferred feedback
30pr-vibe pr 42 --create-issues  # Auto-create issues when deferring
31pr-vibe issues 42              # Create issues from saved report
32pr-vibe issues 42 --dry-run    # Preview without creating
33
34# Check if PR is ready to merge (all bot comments resolved)
35pr-vibe check 42
36
37# View saved reports for a PR
38pr-vibe report 42
39pr-vibe report 42 --list  # List all reports
40pr-vibe report 42 --json  # Output in JSON format
41
42# Post GitHub status check
43pr-vibe status 42         # View status
44pr-vibe status 42 --post  # Post to GitHub
45
46# Export comments for external analysis (Claude Code mode)
47pr-vibe export 42
48
49# Apply decisions from Claude Code
50pr-vibe apply 42
51
52# Clean up old reports
53pr-vibe cleanup
54
55# Specify a different repository
56pr-vibe pr 42 -r owner/repo
57
58# Show what's new
59pr-vibe changelog

Enhanced Output

pr-vibe now provides richer information about your PR:

• Bot Approval Status: See which bots approved your PR
• Priority Breakdown: Comments categorized as must-fix, suggestions, or nitpicks
• PR URL: Direct clickable link to your PR
• Non-Critical Suggestions: Optional improvements shown with --show-all

Example output:

🔍 Analyzing PR #42...
📎 https://github.com/owner/repo/pull/42

🤖 Bot Approval Status
✅ CodeRabbit: Approved - 3 suggestions, 2 nitpicks
❌ DeepSource: Changes Requested - 1 must-fix, 2 suggestions

✨ Summary
  Total comments: 8
  By Priority:
    Must Fix: 1
    Suggestions: 5
    Nitpicks: 2
    
  (2 non-critical suggestions hidden - use --show-all to view)

# Check for updates
pr-vibe update

How It Works

1. Fetches bot comments from your PR (CodeRabbit, Claude Code, DeepSource, etc.)
2. Analyzes each comment with pattern matching and optional LLM
3. Suggests actions: fix, explain, defer, or escalate
4. Handles full conversations including follow-ups and rate limits
5. Learns from your decisions to get smarter over time
6. Saves you 20+ minutes per PR with heavy bot activity

Claude Code Integration

pr-vibe has special support for Claude Code reviews:

• Confidence Levels: Extracts and uses Claude's confidence percentages (e.g., "95% confidence")
• Categories: Understands Claude's MUST_FIX, SUGGESTION, NITPICK categories
• Smart Handling: Skips re-analysis when Claude has already categorized issues
• Priority Mapping: Maps Claude's priorities to pr-vibe's action system
• Approval Detection: Recognizes when Claude approves changes

Example Claude Code comment handling:

Claude Code: "MUST_FIX: SQL injection vulnerability (95% confidence - FACT)"
pr-vibe: Automatically marks for fixing without re-analysis

Pattern Learning

pr-vibe gets smarter with each use. When you reject a bot suggestion as valid for your project, pr-vibe remembers:

1# .pr-bot/patterns.yml
2valid_patterns:
3  - id: console-log-lambda
4    pattern: "console.log"
5    condition:
6      files: ["**/lambda/**", "**/*-handler.js"]
7    reason: "We use console.log for CloudWatch logging"
8    confidence: 1.0

LLM Integration (Optional)

Enhance pr-vibe with LLM analysis:

1# Use Claude (recommended)
2export ANTHROPIC_API_KEY=your-api-key
3pr-vibe pr 42 --llm anthropic
4
5# Use GPT-4
6export OPENAI_API_KEY=your-api-key  
7pr-vibe pr 42 --llm openai
8
9# No LLM needed - pattern matching works great!
10pr-vibe pr 42

Priority-Based Filtering

Focus on what matters most with intelligent priority filtering:

Priority Levels

• Must Fix 🔴: Security vulnerabilities, bugs, breaking changes
• Suggestion 🟡: Code quality, performance, type safety improvements
• Nitpick ⚪: Style, formatting, minor cosmetic issues

Filtering Options

1# Only show critical issues that must be fixed
2pr-vibe pr 42 --critical-only
3
4# Show must-fix and suggestions (hide nitpicks)
5pr-vibe pr 42 --priority-threshold suggestion
6
7# Custom threshold - show all at or above specified level
8pr-vibe pr 42 --priority-threshold nitpick  # Shows everything

Use Cases

1. Pre-release Review: Use --critical-only to focus on blockers
2. Regular Development: Use --priority-threshold suggestion for balanced review
3. Code Quality Sprint: Review all comments including nitpicks
4. Quick Fix Mode: Combine --critical-only --auto-fix for rapid resolution

Priority Summary

Every pr-vibe run shows a priority breakdown:

1By Priority:
2  Must Fix: 2
3  Suggestions: 5
4  Nitpicks: 3
5
6📋 Filtered by priority:
7  Nitpicks: 3 (hidden)

Smart Watch Mode

pr-vibe includes an intelligent watch mode that monitors your PR for bot activity:

• Adaptive Polling: Starts with 5s intervals, gradually increases to 60s
• Bot Completion Detection: Recognizes when bots finish their analysis
• Expected Bot Tracking: Learns which bots typically review your PRs
• Auto-Process Option: Automatically process comments when all bots complete

1# Start watching immediately after creating a PR
2gh pr create ...
3pr-vibe watch 123
4
5# Auto-process when all bots complete their reviews
6pr-vibe watch 123 --auto-process
7
8# Watch with custom timeout and auto-fix
9pr-vibe watch 123 --auto-process --auto-fix --timeout 20

Smart polling intervals:

• 0-30s: Check every 5s (bots respond quickly)
• 30s-2m: Check every 10s (most bots have arrived)
• 2-5m: Check every 20s (waiting for slower bots)
• 5m+: Check every 30s (long-running analysis)

Conversation Management

pr-vibe now handles full conversations with bots:

• Waits for bot responses instead of assuming completion
• Detects rate limits and waits appropriately
• Handles corrections when bots clarify misunderstandings
• Resolves threads automatically when consensus is reached
• Escalates to humans after too many rounds
• Handles long messages by automatically truncating to fit GitHub's 65,536 character limit

Example conversation flow:

You: "This is intentional for CloudWatch"
Bot: "Actually, I was referring to the ESLint issue..."
pr-vibe: "Thank you for the clarification. You're right about the ESLint configuration..."
Bot: "LGTM! Thanks for addressing this."
[Thread resolved automatically]

Message Length Handling

GitHub limits comment bodies to 65,536 characters. pr-vibe automatically:

• Detects when responses exceed the limit
• Truncates intelligently at natural boundaries (code blocks, paragraphs)
• Adds a notice indicating content was truncated
• Retries with aggressive truncation if needed

CLI Workflow Example

1# Morning: New PR from your teammate
2$ pr-vibe pr 147
3🔍 Found 12 bot comments from CodeRabbit
4
5Bot: "Missing null check on user.email"
6> What would you like to do?
7  ✓ Apply fix
8  
9Bot: "console.log found in production code"  
10> What would you like to do?
11  ✓ Post reply: "We use console.log for CloudWatch"
12  
13[pr-vibe detects rate limit from CodeRabbit]
14⏳ Rate limit detected. Waiting 60 seconds...
15
16[After bot responds with clarification]
17💬 CodeRabbit: "Thanks for the explanation. Makes sense for Lambda!"
18✅ Thread resolved automatically
19
20Summary: Fixed 8 issues, explained 3 patterns, skipped 1
21Time saved: ~22 minutes

Reporting & Review

pr-vibe now generates detailed reports for every PR processed:

Comprehensive Reports

• Detailed decision log - See exactly what was done and why
• Conversation transcripts - Full dialogue history with bots
• Confidence scores - Know how certain pr-vibe was about each decision
• Pattern tracking - See which patterns were applied
• Time metrics - Track processing time and time saved

Report Storage

• Reports saved to .pr-bot/reports/pr-{number}/
• Both Markdown and JSON formats
• Automatic cleanup after 30 days (configurable)
• Keep latest 5 reports per PR regardless of age

1# View latest report
2pr-vibe report 42
3
4# List all available reports
5pr-vibe report 42 --list
6
7# Get JSON for programmatic access
8pr-vibe report 42 --json

Pre-Merge Safety

Never accidentally merge a PR with unresolved bot comments:

Check Command

1# Returns exit 0 if ready, 1 if not
2pr-vibe check 42
3
4# Example output:
5✅ Bot Comment Status:
6  - CodeRabbit[bot]: 12/12 resolved ✓
7  - DeepSource[bot]: 3/3 resolved ✓
8  - Total: 15/15 (100%)
9
10✅ PR is ready to merge!

GitHub Status Checks

1# Post status to GitHub
2pr-vibe status 42 --post
3
4# Creates a status check that shows:
5# ✅ "All bot comments resolved (15/15)"
6# ❌ "3 bot comments need attention"

CI Integration

1# .github/workflows/pr-check.yml
2- name: Check bot comments resolved
3  run: |
4    npx pr-vibe check ${{ github.event.pull_request.number }}

Advanced Features

Export Mode for Claude Code

Perfect for AI-powered development workflows:

1# Export PR comments for Claude Code analysis
2pr-vibe export 42 --format claude
3
4# Creates a markdown report optimized for LLM analysis

Team Patterns (Experimental)

Learn from human reviews too:

1pr-vibe pr 42 --experimental
2
3# Now tracks patterns from senior developers
4# "When Alice requests a refactor, it's usually about service boundaries"
5# "Bob always flags missing integration tests"

Project Philosophy

pr-vibe embodies "vibe coding" - the idea that AI tools should work together harmoniously. Instead of fighting with bots or explaining the same patterns repeatedly, let pr-vibe orchestrate the conversation while you focus on building great software.

This tool was born from real frustration during PR reviews and built by Claude while actually responding to CodeRabbit comments. It's uniquely positioned to understand the AI-to-AI collaboration space because it emerged from that exact use case.

Contributing

We love contributions! See CONTRIBUTING.md for guidelines.

1# Fork and clone
2git clone https://github.com/yourusername/pr-vibe.git
3cd pr-vibe
4
5# Install dependencies
6npm install
7
8# Run tests
9npm test
10
11# Make your changes and submit a PR!

Sponsors

pr-vibe is open source and free forever. If it saves you time, consider sponsoring:

Your support helps maintain and improve pr-vibe for everyone! 💜

License

MIT © Andrew Stroup and pr-vibe contributors

---

Built with 💜 by Claude and the vibe coding community

Remember: Code reviews are better when tools vibe together 🎵