Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gennaro-tedesco/gh-i
🔎 search your github issues interactively
https://github.com/gennaro-tedesco/gh-i
command-line gh-extension go
Last synced: about 2 months ago
JSON representation
🔎 search your github issues interactively
- Host: GitHub
- URL: https://github.com/gennaro-tedesco/gh-i
- Owner: gennaro-tedesco
- License: apache-2.0
- Created: 2022-01-30T23:00:00.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-04-05T08:47:00.000Z (over 1 year ago)
- Last Synced: 2024-06-22T21:09:57.010Z (3 months ago)
- Topics: command-line, gh-extension, go
- Language: Go
- Homepage:
- Size: 132 KB
- Stars: 57
- Watchers: 1
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- jimsghstars - gennaro-tedesco/gh-i - 🔎 search your github issues interactively (Go)
README
search your github issues interactively
Installation •
Usage •
Feedback
Search GitHub issues interactively from the command line. Where did you open that bug report three weeks ago? And how many feature requests are still open in your organisation 🤔?
...well say no more:
## Installation
```
gh extension install gennaro-tedesco/gh-i
```
This being a `gh` extension, you of course need [gh cli](https://github.com/cli/cli) as prerequisite.
## Usage
Get started!
```
gh i
```
Without any flags `gh i` shows all the issues created by yourself in order of last update: this is in the vast majority of cases what you are after, is it not? To refine the search, however, the following flags are availabe
```
gh i [flag]
```
takes one of the following arguments or flags
| flags | description | example
|:------------ |:------------------------------------------------ |:--------
| --me | only show issues created by yourself | gh i --me=false
default to true
| -s, --state | search issues by state (open, closed) | gh i -s closed
default to none, namely both
| -t, --title | search for issue title | gh i -t bug-fix
| -b, --body | search in issue body | gh i -b "not working"
| -u, --user | search in repos owned by user only | gh i --me -u @me
| -l, --label | search for issues by label | gh i -l bug -l fix (AND)
gh i -l bug,fix (OR)
| -c, --colour | change colour of the prompt | gh i -c magenta
| -h, --help | show the help page | gh i -h
| -o, --output | print the output to console
default to false, namely open in the browser | gh i -u @me -o | xargs -n1 gh issue view
| -V, --version| print the current version | gh i -V
`gh-i` provides the user with visual output of the selected query in human readable format (according to the list of chosen flags):
```
$ gh i -s open -u @me --me=false
╭──────────────────────────────────────────────╮
│ state:open + author:any + where:your repos │
╰──────────────────────────────────────────────╯
...
```
as well as inline overlay of issue status when browsing through the selection list.
The prompt accepts the following navigation commands:
| key | description
|:------------- |:-----------------------------------
| arrow keys | browse results list
| `/` | toggle search in results list
| `enter ()`| open issue in browser or return its URL as output (if `-o`)
### Execute commands
`gh-i` must be intended as a filter, to browse the issues you created; as such, the best and most flexible way to execute commands with the results is to pipe it into and from `stdin/stdout`. This said, since in most cases one just wants to view and open the corresponding issue, we default to this action, namely upon selection the issue is opened in the web browser; to override this behaviour and return the output instead, use the `-o` flag.
Check the [Wiki](https://github.com/gennaro-tedesco/gh-i/wiki) for more example and the most common use cases!
## Feedback
If you find this application useful consider awarding it a ⭐, it is a great way to give feedback! Otherwise, any additional suggestions or merge request is warmly welcome!
See also the complete family of extensions
- [gh-s](https://github.com/gennaro-tedesco/gh-s) to search for repositories with interactive prompt
- [gh-f](https://github.com/gennaro-tedesco/gh-f) to snap around your git worfklow with `fzf`