revq

revq is a command-line tool designed to streamline the process of reviewing, searching, and filtering GitHub pull requests.

Table of Contents

• Features
• Installation
• Usage
• Configuration
• Motivation
• Future Work
• Contributing
• License

Features

• List pull requests with ease
• Filter pull requests by author
• Filter pull requests by organization
• List pull requests where a review is requested
• Select and open multiple pull requests simultaneously in your default browser
• User-friendly command-line interface

Installation

You can install revq using one of the following methods:

Using Cargo

If you have Rust's package manager, Cargo, installed, you can install revq with:

cargo install revq

Using Homebrew

For macOS users, you can install revq using Homebrew:

brew install k3ii/tap/revq

Check the release page to install the pre-built binaries.

Usage

The general syntax for using revq is:

revq [OPTIONS] [COMMAND]

Options and Subcommands

• -u, --username <USERNAME> Specify GitHub username
• -o, --org Use organization PRs
• -r, --req Show PRs where review is requested
• --all Show all PRs for organization (only works with --org)
• -h, --help Print help information
• -V, --version Print version information

Examples

List your pull requests:

revq

List pull requests for a specific user:

revq -u username

List your pull requests for your organization:

revq -o

List pull requests for a specific user in your organization:

revq -o -u username

List pull requests where your review is requested:

revq -r

List pull requests where your review is requested in your organization:

revq -r -o

List all pull requests for your organization:

revq -o --all

Configuration

To get started with revq, follow these steps:

1. Generate a GitHub Personal access tokens (Fine-grained token) with Content permission having Read-only access.
2. Initialize revq with your GitHub token:

revq init

3. Follow the prompts to enter your GitHub username, token and organization optionally.

To reinitialize or update your configuration:

revq init --force

Motivation

revq was born out of a desire to learn Rust programming and improve upon a simple bash script created by my mentor.

revq offers several advantages over similar tools like gh pr:

• Can be run from any directory in your terminal
• Allows filtering of pull requests based on author and organization
• Enables selection and opening of multiple PRs simultaneously
• Written in Rust for performance and reliability

Future Work

We have exciting plans for future enhancements to revq:

• Allow filtering by mentions
• Allow filtering by assignees
• Support for multiple organizations

Contributing

Contributions are welcome to revq! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

If you encounter any problems or have any questions, please open an issue on our GitHub repository.