PRoctr

PRoctr: Your Terminal Solution for Efficient Pull Request Management

PRoctr is a robust terminal UI designed for streamlining the triage of open pull and merge requests across multiple repositories on platforms including GitHub, GitLab, and Gitea. Primarily targeting automated dependency-update pull requests from tools such as Renovate and Dependabot, it can also manage any pull requests that adhere to specified labels or branch-name prefixes.

This tool enables users to efficiently review, merge, and navigate to repositories directly from the terminal, thus enhancing productivity while dealing with multiple repositories at once.

Key Features

• Cross-Repository Overview: Access a unified table displaying all open pull and merge requests that match your configured labels and branch prefixes from various repositories, complete with indicators for age, mergeable state, pipeline status, and review decisions.
• Support for Multiple Platforms: Effortlessly manage repositories from GitHub, GitLab, and Gitea in a single interface, including instances of self-hosted services, each requiring its own credentials.
• Multi-Select Actions: Select multiple pull requests simultaneously to approve or merge them in bulk, ensuring that failed merges do not impede the processing of successful ones.
• Direct Context Navigation: Open any pull request directly in a web browser or switch to a shell session at its local checkout, facilitating instant access to the project code.
• Customizable Parameters: Tailor merge methods, detection labels, sort orders, and the path to your project registry using a TOML configuration file.
• Concurrent Data Fetching: Utilize parallel queries to fetch data from repositories quickly, ensuring rapid refresh times even with extensive repositories.

Overview of Key Columns in the PR Table

• Mergeable: Indicates if a pull request can be merged without conflict based on the forge’s assessment.
• Pipeline: Displays the current CI pipeline status for the pull request's commit, helping users evaluate the readiness of the request before merging.
• Review Status: Shows the current review decision, offering insights into the approval status of the pull request.

Requirements

• Python 3.11 or newer.
• CLI tools for each forge in use (GitHub CLI, GitLab CLI, Gitea CLI) with proper authentication.

Configuration Overview

Users configure PRoctr through a simple YAML project registry file to specify the repositories to monitor and a TOML configuration file to adjust operational parameters, including label filters and branch prefixes.

Example YAML Configuration

root_path: ~/Git  # Optional path for local clones
myprojects:
  github:
    my-tool:  
      forge: github
      url: https://github.com/myuser/my-tool
  personal:
    proctr:
      forge: github
      url: https://github.com/mxmehl/proctr
  work:
    internal-service:
      forge: gitlab
      url: https://company.example.com/team/internal-service

Efficient Interaction

Navigate the interface using simple keybindings:

PRoctr transforms the management of pull requests into a more straightforward, organized process, making it an essential tool for software development teams managing multiple repositories.