the ultimate compact fzf gh extensionInstallation • Usage • Customisation • Feedback
gh-f
is the ultimate, compact and snappy fzf
extension for gh
cli. It addresses most of your daily GitHub workflow, if not all of it: f
stands for filter, fzf or fomething felse.
Installation
gh extension install gennaro-tedesco/gh-f
Requirements
- fzf
- gnu core utils
- bat (optional, if not detected it uses
less
as a pager, instead)
Usage
Get started!
gh f
shows the help page. Or watch it in action:
gh f [cmd]
takes one of the following arguments or flags
command | description | binds |
---|---|---|
-r,runs | show github workflow runs and filter logs | enter: search run logs |
-p,prs | view, diff and checkout PR | enter: checkout the selected PR ctrl-d: diff the selected PR ctrl-v: view the selected PR |
-b,branches | checkout and diff branches | enter: checkout the selected branch ctrl-d: diff the selected PR |
-l,logs | select commits and show diff | enter: show selected commit diff |
-s,search | search issues in any repository | interactive prompt: follow instructions |
-m,myissue | search issues you opened somewhere | interactive prompt: follow instructions |
-k,pick | cherrypick files between branches | enter: checkout cherrypicked files from branch |
-h,help | show help page | |
-V,version | print the current version |
Customisation
If you want to skip typing gh f
before each command you may alias it directly, for instance
gh set alias prs --shell `gh f -p`
and likewise for the rest.
The prompt colours are defined via their ANSI sequences here: change yourself accordingly, if you like different ones.
Feedback
If you find this application useful consider awarding it a