ptruser / gh-dash

gh cli extension to display a dashboard of PRs and issues - configurable with a beautiful UI.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

gh-dash

✨ A GitHub (gh) CLI extension to display a dashboard with pull requests and issues by filters you care about.

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

  2. Install this extension:

    gh extension install dlvhdr/gh-dash
  3. 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-dash
    
    # github cli
    gh repo clone dlvhdr/gh-dash
  2. cd to it

    cd gh-dash
  3. install it locally bash gh extension install .

Configuring

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

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-dash
    limit: 50 # optional limit per section
issuesSections:
  - title: Created
    filters: is:open author:@me
  - title: Assigned
    filters: is:open assignee:@me
  - title: Subscribed
    filters: is:open -author:@me repo:microsoft/vscode repo:dlvhdr/gh-dash
defaults:
  prsLimit: 20 # global limit
  issuesLimit: 20 # global limit
  preview:
    open: true
    width: 60

Adding a PR or issue section is as easy as adding to the list of prSections or issueSections respectively:

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

Usage

Run:

gh dash

Then press ? for help.

Author

Dolev Hadar dolevc2@gmail.com

About

gh cli extension to display a dashboard of PRs and issues - configurable with a beautiful UI.

License:MIT License


Languages

Language:Go 99.3%Language:Shell 0.7%