→ https://gh-dash.dev ←

A rich terminal UI for GitHub that doesn't break your flow.

📃 Docs

Tip

See the docs site at https://gh-dash.dev to get started

❓ Why use gh-dash

Check out this 10/10 video by Charm ✨ explaining how gh-dash can help you manage your GitHub experience.

✨ Features

• 🌅 fully configurable - define sections using GitHub filters
• 🔍 search for both prs and issues
• 📝 customize columns with hidden, width and grow props
• ⚡️ act on prs and issues with checkout, comment, open, merge, diff, etc...
• ⌨️ set custom actions with new keybindings
• 💅 use custom themes
• 🔭 view details about a pr/issue with a detailed sidebar
• 🪟 write multiple configuration files to easily switch between completely different dashboards
• ♻️ set an interval for auto refreshing the dashboard
• 📁 smart filtering - auto-filter pr/issue lists to the remote tracked by the current directory

📦 Installation

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, follow these steps:

1. Clone the repo

   # git
   git clone https://github.com/dlvhdr/gh-dash

   # GitHub CLI
   gh repo clone dlvhdr/gh-dash

2. Cd into it

   cd gh-dash

3. Build it

   go build

4. Install it locally

   gh extension install .

Updating from an older version

gh extension upgrade dlvhdr/gh-dash

⚡️ Usage

Run

gh dash

Then press ? for help.

Run gh dash --help for more info:

Usage:
  gh dash [flags]

Flags:
  -c, --config string   use this configuration file
                        (default lookup:
                          1. a .gh-dash.yml file if inside a git repo
                          2. $GH_DASH_CONFIG env var
                          3. $XDG_CONFIG_HOME/gh-dash/config.yml
                        )
      --debug           passing this flag will allow writing debug output to debug.log
  -h, --help            help for gh-dash

⚙️ Configuring

See the docs at https://gh-dash.dev/configuration.

🛞 Under the hood

gh-dash uses:

• bubbletea for the TUI
• lipgloss for the styling
• glamour for rendering markdown
• vhs for generating the GIF
• cobra for the CLI
• gh for the GitHub functionality
• delta for viewing PR diffs

Author

Dolev Hadar [email protected]