I've found that managing pull requests efficiently is important for my own productivity and collaboration with others on GitHub. That's why I'm working on this personal project - to create a tool that provides actionable notifications for pull requests, with organization features inspired by Arc Live Folders, and seamless integration with my browser's bookmarks.
PRScout is a browser extension for Chrome and Firefox browsers that I built to solve my own workflow challenges. It notifies you when a pull request is assigned to you, and helps you organize, track, and manage your PRs directly from your browser.
- Notifications: Get notified when PRs are assigned to you
- Multi-category PR Management: View PRs assigned to you, created by you, requesting your review, and mentioning you
- Smart Bookmarks Integration: Automatic bookmark creation/removal in a dedicated folder
- Theme Support: Light, dark, and system preference themes
- Cross-browser Compatibility: Works on Chrome, Firefox, and other Chromium and Firefox-based browsers
- Configurable Polling: Adjust notification frequency to your needs
Coming soon - extension will be available on Chrome Web Store and Firefox Add-ons
- Clone this repository:
git clone https://github.com/codebyrpp/PRScout.git - Open
chrome://extensions/in your browser - Enable "Developer mode" (toggle in top right)
- Click "Load unpacked"
- Select the
extension/folder from the cloned repository
- Clone this repository:
git clone https://github.com/codebyrpp/PRScout.git - Open
about:debuggingin Firefox - Click "This Firefox"
- Click "Load Temporary Add-on"
- Select the
extension/manifest.jsonfile
-
Get a GitHub Personal Access Token:
- Go to GitHub → Settings → Developer settings → Personal access tokens
- Generate a fine grained token with Repository Permissions to Pull Requests with read access.
-
Configure the Extension:
- Click the PRScout icon in your browser toolbar
- Click the settings icon or "Open Options"
- Enter your GitHub Personal Access Token
- Adjust polling interval as needed (default: 60 seconds)
- Choose your preferred theme
- Git
- Chrome or Firefox browser
- GitHub Personal Access Token (PAT)
# Clone the repository
git clone https://github.com/codebyrpp/PRScout.git
cd PRScout
# Load the extension in your browser (see Installation section above)PRScout/
├── extension/ # Main extension files
│ ├── manifest.json # Extension manifest
│ ├── popup.html # Popup interface
│ ├── popup.js # Popup logic
│ ├── background.js # Background service worker
│ ├── api.js # GitHub API integration
│ └── styles/ # CSS with theme support
├── docs/ # Documentation
├── README.md
└── CONTRIBUTING.md # Contributing guidelines
- Manifest V3 compliant browser extension
- Template+cloneNode pattern for dynamic content
- CSS variables for comprehensive theming
- Modular JavaScript with clear separation of concerns
- GitHub API integration with rate limiting and error handling
I welcome contributions from anyone interested in improving PRScout! Whether you're fixing bugs, adding features, improving documentation, or suggesting enhancements - all help is appreciated.
- Fork the repository
- Create a feature branch:
git checkout -b feature/your-feature-name - Make your changes following the code style guidelines
- Test thoroughly in both Chrome and Firefox
- Submit a pull request
For detailed contributing guidelines, please see CONTRIBUTING.md.
Note: This is a personal project, so please be patient with response times. I'll do my best to review contributions and provide feedback as time allows!
- Use CSS variables from
styles/theme.cssfor all colors - Follow template+cloneNode pattern for dynamic HTML
- Use modern ES6+ JavaScript with async/await
- Write descriptive variable and function names
- Follow conventional commit format
This project is open source and available under the MIT License.
- Bug Reports: GitHub Issues
- Feature Requests: GitHub Issues
- Questions: GitHub Discussions
⭐ Star this repository if you find PRScout useful!