All Projects → dlvhdr → gh-prs

dlvhdr / gh-prs

Licence: MIT License
gh cli extension to display a dashboard of PRs - configurable with a beautiful UI.

Programming Languages

go
31211 projects - #10 most used programming language
shell
77523 projects

Projects that are alternatives of or similar to gh-prs

gh-notify
GitHub CLI extension to display GitHub notifications
Stars: ✭ 66 (-85.1%)
Mutual labels:  gh-extension
gh-repo-explore
GitHub CLI extension to interactively explore a repo without cloning
Stars: ✭ 34 (-92.33%)
Mutual labels:  gh-extension
gh-f
🔎 the ultimate compact fzf gh extension
Stars: ✭ 97 (-78.1%)
Mutual labels:  gh-extension
gh-fuzzyclone
No description or website provided.
Stars: ✭ 24 (-94.58%)
Mutual labels:  gh-extension
resto
🔗 a CLI app can send pretty HTTP & API requests with TUI
Stars: ✭ 113 (-74.49%)
Mutual labels:  gh-extension
gh-grep
Print lines matching a pattern in repositories using GitHub API
Stars: ✭ 144 (-67.49%)
Mutual labels:  gh-extension
gh-markdown-preview
GitHub CLI extension to preview Markdown looks like GitHub.
Stars: ✭ 174 (-60.72%)
Mutual labels:  gh-extension
gh-ost
gh extension to meet ghost.
Stars: ✭ 65 (-85.33%)
Mutual labels:  gh-extension
gh-token
Create an installation access token for a GitHub app from your terminal 💻
Stars: ✭ 154 (-65.24%)
Mutual labels:  gh-extension
gh-poi
✨ Safely clean up your local branches
Stars: ✭ 35 (-92.1%)
Mutual labels:  gh-extension

gh-prs

A gh cli extension to display a dashboard with pull requests by filters you care about.

demo

Installation

Installation requires a minimum version (2.0.0) of the the Github CLI to support extensions.

  1. Install the gh cli - see the installation/upgrade instructions

  2. Install this extension:

gh extension install dlvhdr/gh-prs
  1. To get the icons to render properly you should download and install a Nerd font from https://www.nerdfonts.com/. Then, select that font as your font for the terminal.
Installing Manually

if you want to install this extension manually, do these steps:

  1. clone repo

    # git
    git clone https://github.com/dlvhdr/gh-prs
    
    # github cli
    gh repo clone dlvhdr/gh-prs
  2. cd to it

    cd gh-prs
  3. install it locally

    gh extension install .

Configuring

Configuration is provided within a config.yml file under the extension's directory (usually ~/.config/prs/)

The default config.yml file contains:

prSections:
  - title: My Pull Requests
    filters: is:open author:@me
  - title: Needs My Review
    filters: is:open review-requested:@me
  - title: Subscribed
    filters: is:open -author:@me repo:cli/cli repo:dlvhdr/gh-prs
    limit: 50 # optional limit per section
defaults:
  prsLimit: 20 # global limit
  preview:
    open: true
    width: 60

Adding PR sections is as easy as adding to the list of prSections where the properties are:

  • title - shown in the TUI
  • filters - how the repo's PRs should be filtered - these are plain github filters

Usage

Run:

gh prs

Then press ? for help.

Author

Dolev Hadar [email protected]

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].