Skip to content

A Visual Studio Code extension that helps you monitor and manage GitHub pull request review requests with automatic updates, visual priority indicators, and smart notifications.

License

Notifications You must be signed in to change notification settings

Sado4/github-review-manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

15 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ“‹ GitHub Review Manager

A Visual Studio Code extension that helps you monitor and manage GitHub pull request review requests with automatic updates, visual priority indicators, and smart notifications.

Visual Studio Marketplace Version Visual Studio Marketplace Installs

โœจ Features

  • ๐ŸŽฏ Smart Priority Display - Visual priority indicators with emojis based on review urgency
  • ๐Ÿ‘ค Author Avatars - See reviewer profile pictures for quick identification
  • โฐ Time Tracking - Shows time elapsed since last activity with urgency levels
  • ๐Ÿ”” Real-time Notifications - Instant notifications with sound alerts for new review requests
  • ๐Ÿ“Š Detailed Information - Rich tooltips with comprehensive PR details
  • ๐ŸŽฎ Quick Actions - One-click access to PRs and settings
  • ๐Ÿ“ฑ Compact Design - Optimized for narrow sidebars with essential information
  • ๐Ÿ”„ Auto-refresh - Configurable update intervals (minimum 60 seconds)
  • ๐Ÿ“ Multi-view Support - Available in both Activity Bar and Explorer sidebar
  • ๐Ÿค– AI Review Integration - Right-click PR items to request comprehensive AI code reviews
  • ๐Ÿ›ก๏ธ Safe File Management - Automatic cleanup with bulletproof safety for generated review files

๐ŸŽจ Visual Priority System

The extension uses intelligent emoji indicators to show review urgency at a glance:

  • ๐Ÿ†• New - Same day (just requested)
  • โš ๏ธ Attention - 1-2 days old
  • ๐Ÿ”ฅ Urgent - 3-6 days old
  • ๐Ÿšจ Critical - 1 week+ old

Display Format

๐Ÿ”ฅ Fix authentication bug    [username/repo] [Draft]
โš ๏ธ Add new feature          [username/repo] [โšก]
๐Ÿ†• Update documentation     [username/repo]
  • [Draft] - Pull request is still in draft mode
  • [โšก] - Merge conflicts detected

๐Ÿ”‘ Why Classic Tokens?

This extension is designed for multi-repository review management and works best with Classic Personal Access Tokens:

โœ… Classic Token Advantages

  • ๐ŸŒ Universal Access: One token accesses ALL your repositories (personal, organizations, private)
  • ๐Ÿš€ Zero Configuration: Just select repo scope - no manual repository selection needed
  • ๐Ÿข Multi-Organization: Seamlessly works across all organizations you belong to
  • โšก Simple Setup: Generate once, use everywhere

โŒ Fine-grained Token Limitations

  • ๐Ÿ“ Single Target: Each token works for only ONE organization or personal account
  • ๐Ÿ“ Manual Selection: Must individually select every repository you want access to
  • ๐Ÿ”„ Multiple Tokens: Need separate tokens for each organization
  • ๐Ÿ”ฎ Prediction Required: Must anticipate which repositories you'll review in

Bottom Line: Review requests come from anywhere in your GitHub ecosystem. Classic tokens ensure you never miss a review request from any repository you have access to.

๐Ÿš€ Quick Start

  1. Install the extension from the VS Code Marketplace
  2. Configure your GitHub token:
    • Click the ๐Ÿ”‘ "Set Token" button in the GitHub Review Manager view
    • Generate a Classic Personal Access Token with repo scope:
      • Advantage: Access to ALL repositories (personal, organization, private) with a single token
      • Simplicity: No need to select individual repositories
      • Multi-organization support: Works across all organizations you have access to
    • Generate a Classic token here
  3. View your review requests in the Activity Bar or Explorer sidebar

Token Comparison

Feature Classic Token (Recommended) Fine-grained Token
Repository Access โœ… ALL repositories (personal + organizations) โŒ Must select each repository individually
Multi-organization โœ… Access across all organizations โŒ One organization per token
Setup Complexity โœ… Simple - just select repo scope โŒ Complex - manual repository selection
Use Case โœ… Perfect for review managers โŒ Better for specific project access
Token Management โœ… One token for everything โŒ Multiple tokens needed

Why Classic tokens work better for review management:

  • Review requests come from various repositories across different organizations
  • Fine-grained tokens require you to predict and pre-select every repository
  • Classic tokens with repo scope provide seamless access to all your reviewable content

๐Ÿ“ธ Screenshots

Review Request Sidebar

Review requests displayed in sidebar with one-click access to PRs Review requests are displayed in a clean sidebar view with priority indicators and author avatars. Click any item to instantly open the PR in your browser.

Smart Notifications

Notification popup with sound alert for new review requests Get instant notifications with sound alerts when new review requests arrive. Quick action buttons let you view the PR or open the full list.

Status Bar Integration

Status bar showing review request count with color coding The status bar displays your pending review count with smart color coding - yellow for normal requests, red for urgent ones (3+ days old).

โš™๏ธ Configuration

Setting Description Default
Token Classic Personal Access Token with repo scope (recommended for full repository access) Use "Set Token" button
githubReviewManager.refreshInterval Auto-refresh interval in seconds 300 (5 minutes)
githubReviewManager.showNotifications Show notifications for new review requests true
githubReviewManager.playSound Play sound when new review requests arrive true
githubReviewManager.groupByRepository Group review requests by repository in tree view true
githubReviewManager.repositoryFilter ๐Ÿ” Filter to specific repositories only - Show review requests only from specified repositories (e.g., ["mycompany/web-app", "personal/project"]). Leave empty to show all repositories. []

๐Ÿ” Repository Filter Examples

The repositoryFilter setting allows you to focus on specific repositories. Here are common use cases:

Focus on work projects only:

{
  "githubReviewManager.repositoryFilter": [
    "mycompany/frontend",
    "mycompany/backend",
    "mycompany/mobile-app"
  ]
}

Monitor personal projects:

{
  "githubReviewManager.repositoryFilter": [
    "myusername/personal-blog",
    "myusername/side-project"
  ]
}

Mixed work and personal:

{
  "githubReviewManager.repositoryFilter": [
    "company/main-app",
    "opensource/library",
    "personal/portfolio"
  ]
}

๐Ÿ’ก Quick Setup: Go to VS Code Settings (Cmd+,) โ†’ Search "GitHub Review Manager" โ†’ "Repository Filter" and add your repositories one by one!

๐Ÿค– AI Review Feature

Overview

Generate comprehensive AI review prompts for any pull request directly from VS Code. The extension creates intelligent, context-aware prompts that work with any AI tool (Claude, ChatGPT, Gemini, etc.).

How to Use

  1. Right-click on any PR item in the GitHub Review Manager
  2. Select "Generate AI Review Prompt" from the context menu
  3. AI review prompt is automatically copied to clipboard
  4. Paste into your preferred AI tool for instant comprehensive review

What's Included in AI Review Prompts

The extension automatically gathers and formats:

  • ๐Ÿ“‹ PR Information: Title, repository, author, status, and statistics
  • ๐Ÿ“ PR Description: Complete description and context from GitHub
  • ๐Ÿ” Code Changes: Clean diff showing actual changes (merge commits excluded)
  • ๐ŸŽฏ Smart Filtering: Automatically filters out merge commits to focus on actual code changes

Language Detection

The extension intelligently detects the primary language used in PR titles and descriptions:

  • ๐Ÿ‡ฏ๐Ÿ‡ต Japanese: Generates review prompts in Japanese with appropriate context
  • ๐Ÿ‡บ๐Ÿ‡ธ English: Uses English prompts for international projects
  • ๐Ÿง  Smart Detection: Uses character analysis and linguistic patterns for accuracy

Key Features

๐ŸŽฏ Smart Merge Commit Filtering

  • Automatically excludes merge commits from diff analysis
  • Works with any base branch (main, develop, feature branches)
  • Focuses on actual code changes, not branch synchronization

๐Ÿ“‹ Universal AI Tool Compatibility

  • Works with Claude, ChatGPT, Gemini, and any AI tool
  • Clean, formatted prompts ready for immediate use
  • No dependency on specific CLI tools or APIs

๐ŸŒ Intelligent Language Support

  • Auto-detects Japanese vs English content
  • Generates appropriate prompts in the detected language
  • Perfect for international development teams

Example Review Prompt Structure

# PR Review Request

## PR Information
- **Title**: Fix authentication bug
- **Repository**: mycompany/webapp
- **Author**: developer-name
- **Status**: Ready for Review

## Changes Overview
- **Files Changed**: 5
- **Additions**: 45
- **Deletions**: 12

## Code Changes
```diff
[Clean diff with actual changes, merge commits excluded]

Review Request

Please provide a comprehensive code review for this pull request...


### Integration Benefits
- **๐ŸŽฏ Universal Compatibility**: Works with any AI tool or service
- **๐ŸŒ Multi-language**: Supports both Japanese and English workflows  
- **โšก Efficient**: One-click from PR list to ready-to-use prompt
- **๐Ÿงน Clean Output**: Focused on actual changes, not merge noise
- **๐Ÿ“ฑ Simple**: Just copy, paste, and get instant AI reviews

## ๐ŸŽฏ How It Works

The extension uses the GitHub Search API to find pull requests where you're requested as a reviewer:
- Searches for: `type:pr state:open review-requested:@me`
- Sorts by most recent activity (`updated` time) for relevant prioritization
- Fetches detailed information including author avatars, draft status, and change statistics
- Updates automatically based on your configured refresh interval
- Shows notifications with sound alerts for genuinely new review requests

## ๐Ÿ“Š Rich Information Display

### Hover Tooltips
Hover over any review request to see comprehensive details:

```markdown
## ๐Ÿ”ฅ PR #123: Fix authentication bug

๐Ÿ“… PR Created: 2024-01-10 14:30:00
โฐ Last Activity: 2d ago (2024-01-18 16:45:00)

๐Ÿ“ Repository: username/awesome-project
๐Ÿ‘ค Author: developer-name

โœ… Status: Ready for Review
โš ๏ธ Mergeable: Has conflicts

๐Ÿ“Š Changes:
- โž• 45 additions
- โž– 12 deletions
- ๐Ÿ“„ 5 files modified
- ๐Ÿ’ฌ 3 review comments

๐Ÿ”— Open PR in Browser

Smart Time Tracking

  • Priority based on last activity time (more accurate than creation time)
  • Shows both relative time ("2d ago") and exact timestamps
  • Automatically removes completed reviews from the list

๐Ÿ”ง Commands & UI

Toolbar Actions

  • ๐Ÿ”„ Refresh Review Requests - Manually refresh the list
  • ๐Ÿ”‘ Set GitHub Token - Securely configure your GitHub access token
  • ๐Ÿ—‘๏ธ Clear GitHub Token - Remove stored token from secure storage

Context Actions

  • ๐ŸŒ Open PR in Browser - Open selected PR in your default browser
  • ๐Ÿค– Generate AI Review Prompt - Generate comprehensive AI review prompts for any AI tool

๐ŸŽจ UI Components

Activity Bar View

A dedicated sidebar showing all your pending review requests with:

  • ๐Ÿ‘ค Author avatars for quick visual identification
  • ๐ŸŽฏ Priority emojis indicating urgency level
  • ๐Ÿ“ฑ Compact layout optimized for narrow sidebars
  • ๐Ÿ”„ Smart sorting by most recent activity

Explorer Integration

Review requests also appear in the Explorer sidebar when you have pending items.

Status Bar

Clean and intuitive status indicator:

  • ๐Ÿ“Š Simple count display: $(git-pull-request) 3
  • ๐ŸŽจ Smart color coding:
    • ๐ŸŸก Yellow - Any pending reviews
    • ๐Ÿ”ด Red - Reviews 3+ days old (urgent attention needed)
  • ๐Ÿ‘† Click to open review list or configuration
  • ๐Ÿ“‹ Detailed tooltip: Urgency breakdown on hover

Smart Notifications

  • ๐Ÿ”” Instant alerts when new reviews are requested
  • ๐Ÿ”Š Cross-platform sound notifications
  • ๐ŸŽฎ Quick actions: "View PR" and "Open List"
  • โฐ Perfect timing: sound plays with popup display

๐Ÿ” Privacy & Security

  • Your GitHub token is stored securely in VS Code's Secret Storage (encrypted)
  • All API requests are made directly to GitHub - no third-party servers involved
  • The extension only accesses pull requests where you're specifically requested as a reviewer
  • AI review files are safely managed with bulletproof deletion patterns - only extension-generated files are affected by auto-cleanup

๐Ÿ› Troubleshooting

"GitHub token not configured" error

Click the ๐Ÿ”‘ "Set Token" button and enter a Classic Personal Access Token with repo scope for full repository access.

No review requests showing

  • Verify your token has the correct permissions
  • Check that you actually have pending review requests on GitHub
  • Try refreshing manually using the refresh button

Network/API errors

  • Check your internet connection
  • Verify your GitHub token is still valid
  • GitHub API rate limits may apply - the extension respects these limits

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

๐Ÿ“„ License

This project is licensed under the MIT License.

๐Ÿ”— Links

About

A Visual Studio Code extension that helps you monitor and manage GitHub pull request review requests with automatic updates, visual priority indicators, and smart notifications.

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published